פתרון בעיות

בדף הזה מוצג מידע על פתרון בעיות שקשורות ל-Trace.

בעיות מוכרות

בקטע הזה מפורטות בעיות מוכרות:

  • לא ניתן לגשת לטווחים שנכתבו ל Google Cloud פרויקט באמצעות Telemetry API דרך Cloud Trace API. לדוגמה, אם תנסו לרשום את העקבות האלה, הפקודה תיכשל עם שגיאה 404 Not Found.

פתרון בעיות ב-Observability Analytics

בקטע הזה מוסבר איך לפתור בעיות שאתם עשויים לראות כשאתם משתמשים ב-Observability Analytics כדי לשלוח שאילתות לנתוני המעקב.

אי אפשר לשמור את מדיניות ההתראות בגלל שגיאת אימות

כשמנסים לשמור מדיניות התראות שעוקבת אחרי נתוני ה-trace, מקבלים שגיאה שדומה לשגיאה הבאה:

The following error occurred when validating your SQL Alert: Error authenticating service account `service-12345@gcp-sa-monitoring-notification.iam.gserviceaccount.com`. BigQuery returned an error.

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

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

  1. במסוף Google Cloud , נכנסים לדף APIs & Services ומפעילים את Cloud Monitoring API:

    עוברים אל APIs & Services

  2. נכנסים לדף IAM במסוף Google Cloud :

    כניסה לדף IAM

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

  3. בדף IAM, מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Include Google-provided role grants.

    2. אם חשבון השירות של המעקב לא מופיע ברשימה, צריך ליצור מדיניות התראות מבוססת-SQL ולנסות לשמור את המדיניות.

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

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

הודעת שגיאה שמודיעה שתצוגה לא קיימת

מזינים שאילתת SQL בחלונית השאילתות בדף Observability Analytics, אבל מנתח ה-SQL מציג את השגיאה הבאה:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID does not exist

השגיאה הקודמת מדווחת אם לא ניתן למצוא את התצוגה שצוינה בהצהרה FROM.

כדי לפתור את השגיאה הזו, צריך לוודא שלתצוגה יש תחביר תקין:

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

  • אם מזהה הפרויקט, המיקום, מזהה הקטגוריה, מזהה מערך הנתונים או מזהה התצוגה מכילים נקודות, (.), צריך לוודא שהשדה מוקף במירכאות הפוכות בודדות, (`). Google Cloud

    לדוגמה, אם מזהה הפרויקט שלכם Google Cloud הוא example.com:bluebird, אז ההצהרה FROM תהיה:

    FROM `example.com:bluebird`.`us`.`_Trace`.`Spans`.`_AllSpans`

מוצגת ההודעה 'תחילת העבודה עם ניתוח נתונים של יכולת התבוננות'

פותחים את הדף Observability Analytics ומוצג חלון עם הודעה דומה לזו:

Get started with Observability Analytics

כדי להשתמש ב-Observability Analytics, לוחצים על סגירה בחלון.

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

הצטרפות של כמה תצוגות נכשלת

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

לא ניתן להצטרף לכל הצפיות.

ההגבלות הבאות חלות על הצטרפות לתצוגות:

  1. המיקומים של התצוגות עומדים באחד מהתנאים הבאים:

    • לכל התצוגות יש את אותו המיקום.
    • כל התצוגות נמצאות במיקום global או us.

  2. כשמשאבי אחסון משתמשים במפתחות הצפנה בניהול הלקוח (CMEK), אחד מהתנאים הבאים מתקיים:

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

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

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

  • משאבי האחסון לא משתמשים ב-CMEK.
  • משאב אחסון אחד משתמש ב-CMEK והשני לא.
  • שני משאבי האחסון משתמשים ב-CMEK ובאותו מפתח Cloud KMS.

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

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

יצירת מערך נתונים מקושר ב-BigQuery נכשלת עם שגיאת הרשאה

אתם מנסים ליצור מערך נתונים מקושר ב-BigQuery, אבל הפעולה נכשלת עם שגיאה שדומה לשגיאה הבאה: