עדכון קטגוריות של נתונים שניתנים לצפייה

אפשר לעדכן את השם המוצג, התיאור או המפתח של Cloud Key Management Service של קטגוריית נתונים למעקב כדי לשקף שינויים ארגוניים או להחליף מפתחות הצפנה.

אי אפשר להשתמש בפעולות העדכון האלה כדי לפתור בעיות שקשורות לתאימות. לדוגמה, אי אפשר להשתמש בפעולות האלה כדי לשנות את המיקום של קטגוריית נתונים לצפייה או להחיל מפתח Cloud KMS על קטגוריה שמשתמשת בהצפנה שמוגדרת כברירת מחדל ב-Google.

ההשפעות של עדכון מפתח Cloud KMS

עדכון מפתח Cloud KMS לקטגוריה של נתוני Observability לא משפיע על הנתונים המאוחסנים. כלומר, לפני שהעדכון מסתיים, המפתח המקורי מצפין נתונים חדשים. אחרי שהעדכון מסתיים, המפתח המעודכן מצפין נתונים חדשים.

תוכלו להמשיך לגשת לנתונים המאוחסנים ולצפות בהם בתנאי שמפתח Cloud KMS המקורי יישאר מופעל ולחשבון השירות של Google Cloud Observability יישארו הרשאות ההצפנה והפענוח.

אם משביתים או משמידים את מפתח Cloud KMS המקורי, כל הנתונים שנכתבו בזמן שהמפתח היה פעיל הופכים באופן מיידי לבלתי נגישים ובלתי קריאים באופן קבוע.

מגבלות

ההגבלות הבאות חלות:

• אי אפשר לשנות את המיקום.
• אי אפשר להחיל מפתח Cloud KMS על מאגר נתונים של יכולת צפייה שמשתמש בהצפנה שמוגדרת כברירת מחדל ב-Google.
• השם המוצג לא יכול לחרוג מ-100 בייטים מקודדים.
• התיאור לא יכול לחרוג מ-1,000 בייטים מקודדים.
• הנתונים נשמרים למשך 30 ימים. אפשר להשמיט את תקופת השמירה או להגדיר אותה ל-30.
• אם מעדכנים את מפתח Cloud KMS, המיקום של המפתח צריך להיות זהה בדיוק למיקום האב של קטגוריית הנתונים לצפייה.

לפני שמתחילים

מגדירים את הפרויקט ואת תפקידי ה-IAM, ובוחרים את הממשק שמתכננים להשתמש בו.

הגדרת הפרויקט והתפקידים

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. כדי לקבל את ההרשאות שנדרשות לעדכון של קטגוריות של נתונים שניתנים למעקב, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Observability Editor (roles/observability.editor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

   יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

הגדרת ממשקים

הגדרת מפתח Cloud KMS

זה שינוי אופציונלי. אם אתם מתכננים לעדכן את מפתח Cloud KMS שבו משתמשת קטגוריית הנתונים לצפייה, אתם צריכים לבצע את הפעולות הבאות:

1. מפעילים את Cloud Key Management Service API, אם הוא עדיין לא מופעל.

   תפקידים שנדרשים להפעלת ממשקי API

   כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

   להפעלת ה-API

2. יצירה של אוסף מפתחות ומפתח

   המיקום של קטגוריית הנתונים למעקב צריך להיות זהה למיקום של המפתח.

3. מחליפים את PROJECT_ID במזהה הפרויקט ומריצים את הפקודה הבאה:

   gcloud observability settings describe \
   --location=global --project=PROJECT_ID
   

   בתגובה לפקודה הקודמת מופיע המזהה של חשבון השירות של Google Cloud Observability.

4. מקצים לחשבון השירות של Google Cloud Observability את התפקיד Cloud KMS CryptoKey Encrypter/Decrypter.

   gcloud kms keys add-iam-policy-binding \
   --project=KMS_PROJECT_ID \
   --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-observability.iam.gserviceaccount.com \
   --role=roles/cloudkms.cryptoKeyEncrypterDecrypter \
   --location=KMS_KEY_LOCATION \
   --keyring=KMS_KEY_RING \
   KMS_KEY_NAME
   

   לפני שמריצים את הפקודה הקודמת, מחליפים את המשתנים הבאים בערכים:

   • ‫KMS_PROJECT_ID: המזהה האלפאנומרי הייחודי, שמורכב מ Google Cloud שם הפרויקט וממספר שהוקצה באופן אקראי, של הפרויקט Google Cloud שמריץ את Cloud KMS. במאמר זיהוי פרויקטים מוסבר איך מקבלים את המזהה הזה.
   • service-PROJECT_NUMBER: השם של חשבון השירות של Google Cloud Observability שמופיע בשלב הקודם.
   • ‫KMS_KEY_LOCATION: האזור של מפתח Cloud KMS.
   • ‫KMS_KEY_RING: השם של אוסף המפתחות ב-Cloud KMS.
   • ‫KMS_KEY_NAME: שם המפתח של Cloud KMS. הפורמט הוא: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY.

עדכון של קטגוריית נתונים של יכולת תצפית

gcloud observability buckets update BUCKET_ID \
 --location=LOCATION \
 --description="DESCRIPTION" \
 --display-name="DISPLAY_NAME" \
 --project=PROJECT_ID

gcloud observability buckets update BUCKET_ID `
 --location=LOCATION `
 --description="DESCRIPTION" `
 --display-name="DISPLAY_NAME" `
 --project=PROJECT_ID

gcloud observability buckets update BUCKET_ID ^
 --location=LOCATION ^
 --description="DESCRIPTION" ^
 --display-name="DISPLAY_NAME" ^
 --project=PROJECT_ID

Request issued for: [_Trace]
Waiting for operation [projects/my-project/locations/us/operations/operation-1790096940299-65c156c3d730f-5fbc9362-10d93b76] to complete...done.
Updated bucket [_Trace].
createTime: '2026-09-09T21:06:30.590367694Z'
description: Updated bucket for storing trace data
displayName: Updated display name
name: projects/my-project/locations/us/buckets/_Trace
updateTime: '2026-09-22T17:09:00.301850190Z'

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

{
    "description": "Updated description for my observability bucket."
}

המאמרים הבאים

• חיפוש ועריכה של עקבות
• הרצת שאילתות על עקבות וניתוח שלהן באמצעות SQL