תיקון הדרישות לגבי מיקום אחסון הנתונים ו-CMEK

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

כדי להקצות מחדש קטגוריה, צריך לקבוע את הגדרות ברירת המחדל ואז להפעיל את ה-method ‏reprovision. פעולת ההקצאה מחדש יכולה לבצע את הפעולות הבאות:

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

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

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

איך פועל תהליך ההקצאה מחדש

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

1. המערכת קובעת אם אפשר להקצות מחדש את קטגוריית התצפית. קטגוריית תצפיתיות עומדת בדרישות אם היא עוברת את כל הבדיקות הבאות:

   • השם של קטגוריית התצפית הוא _Trace.
   • הקטגוריה לא הוקצתה מחדש.
   • הגדרות ברירת המחדל של קטגוריות התצפית נמצאות.
   • כדי שהמיקום של קטגוריית הניטור יתאים להגדרות ברירת המחדל, צריך לשנות את המיקום של קטגוריית הניטור או לשנות את ההצפנה מהצפנת ברירת המחדל של Google ל-CMEK.

2. המערכת מעדכנת את ההגדרות של הקטגוריה. התהליך הזה נמשך בין ארבע לחמש שעות.

מגבלות

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

• המערכת מאפשרת פעולת הקצאה מחדש אחת לכל היותר לכל קטגוריית ניראות (observability). הבקשות הבאות נכשלות ומתקבלת השגיאה FAILED_PRECONDITION.

• אפשר להקצות מחדש רק קטגוריות בשם _Trace.

• אי אפשר לגשת לנתונים שאוחסנו לפני שהתחילה ההקצאה מחדש. הנתונים האלה נמחקו ואי אפשר לשחזר אותם.

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

• אם המיקום של הקטגוריה משתנה, צריך לעדכן ידנית את תצוגות ניתוח הנתונים הקיימות.

• אי אפשר לבטל או להחזיר למצב הקודם פעולה של הקצאה מחדש. המערכת מתעלמת מניסיונות לבטל את הפעולה.

• ההתנהגות של שאילתות במהלך פעולת הקצאה מחדש לא מוגדרת.

  הערה: לא מומלץ להשתמש בדפים Trace Explorer או Observability Analytics במהלך הקצאה מחדש. צריך להמתין עד שהפעולה תסתיים.

ביצוע בקרה

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

כדי למצוא את הרשומות האלה, מפעילים את המסננים הבאים ב-Logs Explorer:

logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity" AND
resource.type="audited_resource" AND
resource.labels.service="observability.googleapis.com" AND
resource.labels.method="google.cloud.observability.v1.Observability.ReprovisionBucket"

בדוגמה החלקית הבאה מוצג יומן ביקורת של פעילות אדמין:

  {
    "logName": "projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity",
    "resource": {
      "type": "audited_resource",
      "labels": {
        "project_id": "PROJECT_ID",
        "service": "observability.googleapis.com",
        "method": "google.cloud.observability.v1.Observability.ReprovisionBucket"
      }
    },
    "protoPayload": {
      "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
      "status": {
        "code": 0,
        "message": "OK"
      },
      ...
      "serviceName": "observability.googleapis.com",
      "methodName": "google.cloud.observability.v1.Observability.ReprovisionBucket",
      "authorizationInfo": [...]
      "resourceName": "projects/PROJECT_ID/locations/us/buckets/_Trace",
      "request": {
        "@type": "type.googleapis.com/google.cloud.observability.v1.ReprovisionBucketRequest",
        "name": "projects/PROJECT_ID/locations/us/buckets/_Trace"
      },
      "response": {
        "@type": "type.googleapis.com/google.longrunning.Operation",
        "name": "projects/PROJECT_ID/locations/us/operations/reprovision-123456789-0",
        "done": false,
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.observability.v1.OperationMetadata",
          "target": "projects/PROJECT_ID/locations/us/buckets/_Trace",
          "verb": "reprovision",
          "apiVersion": "v1"
        }
      }
    },
    "severity": "NOTICE",
    "timestamp": "2026-06-30T16:54:02.123456Z"
  }

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

1. קוראים את המגבלות.

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

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

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

הקצאה מחדש של קטגוריית ניראות

כדי להקצות מחדש קטגוריית ניראות (observability):

1. קביעת הגדרות ברירת המחדל של קטגוריות התצפית
2. הקצאה מחדש של הקטגוריה
3. מעקב אחרי ההתקדמות
4. יצירת קישורים באופן ידני ועדכון תצוגות ניתוח נתונים

קביעת הגדרות ברירת המחדל של קטגוריות הניראות (observability)

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

במאמר הגדרת ברירות מחדל לקטגוריות של ניראות מוסבר איך להציג ולהגדיר את הגדרות ברירת המחדל.

הקצאה מחדש של הקטגוריה

השתמשו בסקריפטים ששולחים את בקשת ההקצאה מחדש באופן אסינכרוני, ודוגמים כדי לקבוע מתי פעולת ההקצאה מחדש הושלמה. כדי להקצות מחדש קטגוריית תצפית, משתמשים ב-method‏ projects.locations.buckets.reprovision.

צריך לציין את שם הקטגוריה של הניראות (observability), בפורמט הבא:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

המשמעות של השדות בביטוי שלמעלה:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של קטגוריית הניטור.
• ‫BUCKET_ID: המזהה של קטגוריית הניטור. המזהה הזה חייב להיות _Trace.

התגובה היא אובייקט Operation. בשדה Operation.done מוצג מידע על ההתקדמות:

• ‫done הוא false: הפעולה מתבצעת. למידע על דגימת הפעולה, ראו מעקב אחרי ההתקדמות.

• ‫done הוא true: הפעולה הושלמה והשדה error או response מוגדר:

  • response מוגדר: מציין שהפעולה האסינכרונית הושלמה בהצלחה. הערך משקף את המצב האחרון של קטגוריית הניטור שהייתה היעד להקצאה מחדש.

  • ‫error מוגדר: מציין שהפעולה האסינכרונית נכשלה. הערך של השדה הזה הוא אובייקט Status שמכיל קוד שגיאה של gRPC והודעת שגיאה. למידע על הודעות שגיאה נפוצות, ראו הודעות שגיאה.

בדרך כלל, תהליך ההקצאה מחדש נמשך ארבע עד חמש שעות.

מעקב אחרי ההתקדמות

האובייקט Operation מכיל מידע על ההתקדמות. דוגמים את הפעולה עד שהערך בשדה Operation.done הוא true. אחר כך אפשר להשתמש בשדות Operation.response ו-Operation.error כדי לקבוע אם ההקצאה מחדש הצליחה או נכשלה.

כדי לדגום את Operation, משתמשים ב-method‏ folders.locations.operations.get.

מגדירים את הפרמטר של הנתיב לשם הפעולה:

operations/UNIQUE_ID

השדה UNIQUE_ID הוא המזהה הייחודי של הפעולה.

התגובה היא אובייקט Operation מעודכן.

אם האפליקציה מקבלת תגובה מסוג HTTP 503 / UNAVAILABLE בזמן הדגימה, צריך להטמיע השהיה מעריכית לפני ניסיון חוזר (exponential backoff) ולנסות שוב את הבקשה. השגיאה הזו מציינת שהבקשה נכשלה בשכבת התעבורה או בשכבת הרשת.

יצירת קישורים באופן ידני ועדכון תצוגות ניתוח נתונים

אחרי שההקצאה מחדש מסתיימת, יוצרים מחדש את הקישורים ומעדכנים את תצוגות ניתוח הנתונים.

לדוגמה, אתם יכולים:

1. מציגים את הקישורים במערך הנתונים של יכולת התצפית. בתרחישים מסוימים, פעולת ההקצאה מחדש שומרת על הקישורים. למידע נוסף על השלב הזה, ראו הצגת רשימת הקישורים במערך נתונים.

2. יוצרים מחדש את מערך הנתונים המקושר ב-BigQuery. למידע נוסף על השלב הזה, ראו יצירת קישור במערך נתונים.

3. בודקים את תצוגות ניתוח הנתונים ומעדכנים את הנתיב לקטגוריית הניראות לפי הצורך.

הודעות שגיאה

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

FAILED_PRECONDITION

הודעת השגיאה FAILED_PRECONDITION מציינת שאי אפשר להקצות מחדש את קטגוריית הניטור.

דוגמה להודעת שגיאה:

{
    "error":{
        "code": 400,
        "message": "Only _Trace buckets can be reprovisioned.",
        "status": "FAILED_PRECONDITION",
        "details": [ ... ]
    }
}

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

INVALID_ARGUMENT

הודעת השגיאה INVALID_ARGUMENT מציינת שהמיקום של קטגוריית הניטור והגדרת ה-CMEK תואמים להגדרות ברירת המחדל של קטגוריות הניטור.

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

PERMISSION_DENIED

הודעת השגיאה PERMISSION_DENIED מציינת שאין לכם את תפקידי ה-IAM הנדרשים כדי להקצות מחדש קטגוריית תצפית.

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

פתרון בעיות

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

איך אפשר לדעת אם קטגוריה הוקצתה מחדש?

שולחים שאילתה ליומני הביקורת ומסננים את הרשומות ביומן לפי שם היומן, השירות והשיטה. מידע נוסף זמין בקטע ביקורת במאמר הזה.

למה בפרויקט שלי יש שתי קטגוריות של נתוני מעקב?

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

• אם תציגו את רשימת הקטגוריות של נתוני התצפיות בפרויקט, שתי הקטגוריות יופיעו בתוצאות.

• אם אתם משתמשים ב-Observability Analytics כדי לשלוח שאילתות לנתוני המעקב, תצוגת _AllSpans זמינה לשני המאגרים.

אתם לא צריכים לעשות כלום.

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

למה הנתונים שמתקבלים בשאילתות שונים אחרי הקצאה מחדש?

פעולת הקצאה מחדש מוחקת את כל הנתונים שאוחסנו לפני שהפעולה התחילה. אי אפשר לשחזר את הנתונים האלה.

למה לא מוצגים נתונים ב-Trace Explorer אחרי הקצאה מחדש?

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

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

הבעיה הזו נפתרת מעצמה אחרי שפג הזמן הקצוב של המטמון, בערך אחרי 10 דקות.

למה אי אפשר להקצות מחדש את קטגוריית הניראות?

אם פעולת ההקצאה מחדש נכשלת עם הסטטוס FAILED_PRECONDITION, אי אפשר להקצות מחדש את קטגוריית הניטור הרלוונטית. הנה כמה סיבות לכך שאי אפשר להקצות מחדש קטגוריה:

• שם הקטגוריה של נתוני התצפיתיות הוא לא _Trace.
• מספר הפעמים שהוקצה מחדש קטגוריית הניטור גדול מאחת. אתם יכולים לשלוח שאילתה ליומני הביקורת כדי לבדוק אם הקצאת הקטגוריה חודשה.
• הגדרות ברירת המחדל של קטגוריות התצפית לא נמצאו. כדי לפתור את הבעיה, צריך להגדיר את ברירות המחדל של קטגוריות התצפית ולנסות שוב להריץ את הפקודה.
• ההגדרה של קטגוריית הניראות תואמת להגדרות ברירת המחדל. כלומר, פעולת ההקצאה מחדש לא תשנה את ההגדרה של קטגוריית הניטור.
• כדי להתאים להגדרות ברירת המחדל, המערכת צריכה להחליף את ה-CMEK בהצפנה בניהול Google. הפעולה הזו לא נתמכת.