צפייה ביומנים של מופעים

בדף הזה מוסבר איך למצוא את Cloud Logging ואיך להשתמש בו כדי להציג יומנים ולבצע בהם שאילתות עבור מכונת Cloud SQL.

‫Cloud SQL משתמש ב-Cloud Logging. מידע מלא זמין במאמרי העזרה בנושא Cloud Logging. כדאי גם לעיין בדוגמאות לשאילתות ב-Cloud SQL.

צפייה ביומנים

כדי לראות את הרשומות ביומן של מכונת Cloud SQL:

המסוף

  1. נכנסים לדף Cloud Logging במסוף Google Cloud .

    כניסה ל-Cloud Logging

  2. בוחרים פרויקט קיים של Cloud SQL בחלק העליון של הדף.
  3. ב-Query builder, מוסיפים את הפרטים הבאים:
    • משאב: בוחרים באפשרות מסד נתונים של Cloud SQL. בתיבת הדו-שיח, בוחרים מכונה של Cloud SQL.
    • שמות היומנים: גוללים לקטע Cloud SQL ובוחרים את קובצי היומן המתאימים למופע. לדוגמה:
      • cloudsql.googleapis.com/sqlagent.out
      • cloudsql.googleapis.com/sqlserver.err
    • רמת חומרה: בוחרים רמת יומן.
    • טווח זמן: בוחרים הגדרה קבועה מראש או יוצרים טווח בהתאמה אישית.

gcloud

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

gcloud logging read "resource.type=cloudsql_database" \
--project=PROJECT-ID \
--limit=10 \
--format=json

צפייה ביומן הפעולות של המכונה

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

  • השעה שבה הפעולה הסתיימה, לפי אזור הזמן המקומי.
  • סוג הפעולה.
  • הסטטוס של הפעולה.
  • הודעה שמתארת את התוצאה של הפעולה.

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

כדי לראות את יומן הפעולות של מופע:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
  3. לוחצים על Operations כדי לעבור לחלונית שבה מוצג יומן הפעולות.
הערה: יומן הפעולות לא כולל פעולות שבוצעו באמצעות כלי ניהול חיצוניים, כמו כלי שורת הפקודה של SQL Server. רק פעולות של ניהול משתמשים ושינוי סיסמאות שבוצעו באמצעות מסוףGoogle Cloud , ‏ה-CLI של gcloud או Cloud SQL Admin API מופיעות ביומן הפעולות.

צפייה ביומני האפליקציה

אפליקציות שמתחברות ל-Cloud SQL מאחסנות את היומנים שלהן במיקומים שונים.

‫App Engine (סביבה גמישה)

בקטע Compute > App Engine > Services:

  • ברשימת השירותים, מוצאים את השירות הרצוי.
  • לוחצים על התפריט הנפתח כלים.
  • בוחרים באפשרות logs (יומנים).

בקטע Operations > Logging > Logs explorer במסוף Google Cloud , משתמשים בשאילתה הבאה:

resource.type="gae_app"
resource.labels.module_id="default"

Cloud Run

אפשר לראות את היומנים בקטע Logs Explorer של Cloud Run במסוףGoogle Cloud . שימו לב ש-Cloud Run מדווח רק על הודעות שגיאה משרת ה-proxy ל-Cloud SQL Auth. משתמשים בשאילתה כמו זו שבהמשך:

resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"

שרת proxy ל-Cloud SQL Auth

ב-Operations > Logging > Logs explorer, משתמשים בשאילתה הבאה:

log_id("appengine.googleapis.com/cloud-sql-proxy")

הצגה של יומני ביקורת

אפשר לראות את סוגי יומני הביקורת הבאים עבור מכונות Cloud SQL:

  • פעילות אדמין: כוללת פעולות של אדמינים שכותבים מטא-נתונים או מידע על הגדרות. אי אפשר להשבית את היומנים האלה.
  • Data Access: כולל פעולות של אדמינים שקוראים מטא-נתונים או מידע על הגדרות. היומנים האלה כוללים גם פעולות שבהן נקראים או נכתבים נתונים שהמשתמשים סיפקו. כדי לקבל את יומני הביקורת Data Access, אתם צריכים להפעיל אותם באופן מפורש.
  • אירוע מערכת: זיהוי פעולות אוטומטיות ב- Google Cloud שמשנות את ההגדרות של משאבים. אי אפשר להשבית את היומנים האלה.

מידע נוסף על צפייה ביומני הביקורת Admin Activity,‏ Data Access ו-System Event זמין במאמר צפייה ביומנים.

תמחור

למידע נוסף על התמחור של Cloud Logging, ראו מחירון מקוצר של Cloud Logging.

פתרון בעיות

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

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

חלק מהיומנים מסוננים מתוך היומן error.log של מכונת Cloud SQL ל-SQL Server. יומנים מסוננים כוללים יומני AD בלי חותמות זמן, וכוללים: Login failed for user 'x'. Reason: Token-based server access validation failed with an infrastructure error. Login lacks connect endpoint permission. [CLIENT: 127.0.0.1]. היומנים האלה מסוננים כי הם עלולים לגרום לבלבול.
קשה לקרוא את קובצי היומן. אתם מעדיפים לראות את היומנים בפורמט JSON או טקסט.אתם יכולים להשתמש בפקודה gcloud logging read יחד עם פקודות לעיבוד שלאחר ההורדה ב-Linux כדי להוריד את היומנים.

כדי להוריד את היומנים כקובץ JSON:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json
    

כדי להוריד את היומנים כקובץ TEXT:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt