צפייה ביומני פעילות

יומני הפעילות של Compute Engine הוצאו משימוש. במקום זאת, צריך להשתמש ביומני ביקורת. מידע נוסף זמין במאמר בנושא מעבר מיומני פעילות ליומני ביקורת.

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

‫Compute Engine מספק יומני פעילות שמאפשרים לעקוב אחרי אירועים מסוימים שמשפיעים על הפרויקט, כמו קריאות ל-API ואירועים במערכת. באופן ספציפי, יומני הפעילות מספקים מידע על:

• קריאות ל-Compute Engine API: אירועי GCE_API_CALL הם קריאות ל-API שמשנות את המצב של משאב. לדוגמה, קריאות ל-API ליצירת דיסק, לעדכון מטא-נתונים של מופע, ליצירת קבוצת מופעים או לשינוי סוג מכונה מתועדות ביומני הפעילות. קריאות ל-API שלא מעדכנות משאב, כמו בקשות get ו-list, לא נרשמות.
• יומני פעולות: אירועים מתועדים כשקריאה ל-API משנה את מצב המשאב ומסתיימת.‏ Compute Engine מחזיר אירוע של פעולה שהושלמה, שמתועד ביומני הפעילות.GCE_OPERATION_DONE
• יומני מערכת: אירועים מתועדים כש-Compute Engine מבצע אירוע מערכת, והם נרשמים ביומני פעילות.GCE_SYSTEM_EVENT לדוגמה, אירוע תחזוקה שקוף יתועד כאירוע מערכת.

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

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

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

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

• יש לכם ניסיון בשימוש ב-Cloud Logging.
• אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Cloud de Confiance by S3NS . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

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

  המסוף

  כשמשתמשים במסוף Cloud de Confiance כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Cloud de Confiance by S3NS

  gcloud

  1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

     gcloud init

• הגדרת אזור ותחום כברירת מחדל

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

ההרשאות שנדרשות למשימה הזו

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

• ‫logging.logServiceIndexes.list בפרויקט
• ‫logging.logServices.list בפרויקט

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

רישום הפעילות מופעל כברירת מחדל בכל הפרויקטים של Compute Engine.

אפשר לראות את יומני הפעילות של הפרויקט באמצעות Logs Explorer ב- Cloud de Confiance console:

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

   כניסה לדף Logging

2. בכלי Logs Explorer, בוחרים את סוג המשאב ומסננים אותו מהרשימה הנפתחת הראשונה.
3. ברשימה הנפתחת All logs (כל היומנים), בוחרים באפשרות compute.googleapis.com/activity_log כדי לראות את יומני הפעילות של Compute Engine.

יומני ניתוב

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

זיהוי קובצי יומן

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

קבצי היומן של Compute Engine מאוחסנים במבנה הספריות הבא:

<bucket>/compute.googleapis.com/activity_log/<year>/<month>/<day>

זו דוגמה לשם קובץ יומן שמאוחסן בקטגוריה של Cloud Storage בשם my-bucket:

my-bucket/compute.googleapis.com/activity_log/2014/10/31/20:00:00_20:59:59_S0.json

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

<dataset>.compute_googleapis_com_activity_log_YYYYMMDD

מידע על שאילתות ביומני פעילות ב-BigQuery זמין במאמר רשומות ביומן ב-BigQuery.

קריאת יומני פעילות

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

ביומני הפעילות של Compute Engine מופיעים:

• ‫compute.googleapis.com/activity_log כערך של השדה log
• ‫metadata, שמתאר מידע נפוץ כמו חותמת זמן
• ‫structPayload, שמכיל את התוכן הספציפי של רשומת היומן

בתיאור של LogEntry אפשר לקבל פרטים נוספים על השדות הנפוצים שמופיעים בכל רשומה ביומן, אבל תוכן המטען הייעודי (payload) של רשומות ביומן הפעילות הוא ספציפי ל-Compute Engine, והוא מתואר בהמשך.

תוכן המטען הייעודי (payload)

התוכן של רשומה ביומן מסופק בפורמט אובייקט JSON ומאוחסן בשדה structPayload. השדה structPayload מכיל את הפרטים הבאים:

"request": {
  "url": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances\",
  "body": "{
    \"canIpForward\":"false",
    \"description\":\"\",
    \"disks\":[{
      \"autoDelete\":true,
      \"boot\":true,
      \"deviceName\":\"example-instance\",
      \"initializeParams\":{
        \"diskSizeGb\":\"10\",
        \"diskType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/diskTypes/pd-standard\",
        \"sourceImage\":\"https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-8-jessie-v20150818\"
      },
      \"mode\":\"READ_WRITE\",
      \"type\":\"PERSISTENT\"
    }],
    \"machineType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/machineTypes/n1-standard-1\",
    \"metadata\":{
      \"items\":[]
    },
    \"name\":\"example-instance\",
    \"networkInterfaces\":[{
        \"accessConfigs\":[{
          \"name\":\"External NAT\",
          \"type\":\"ONE_TO_ONE_NAT\"
        }],
        \"network\":\"https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\"
      }],
    \"scheduling\":{
      \"automaticRestart\":true,
      \"onHostMaintenance\":\"MIGRATE\",
      \"preemptible\":false
    },
    \"serviceAccounts\":[{
      \"email\":\"default\",
      \"scopes\":[
        \"https://www.googleapis.com/auth/devstorage.read_only\",
        \"https://www.googleapis.com/auth/logging.write\"
      ]
    }],
    \"tags\":{
      \"items\":[]
    },
    \"zone\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f\"
  }"
}

"resource": {
  "type": "instance",
  "name": "example-instance",
  "id": "0",
  "zone": "us-central1-f"
}

trace_id: "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e"

דוגמה לרשומה ביומן

לדוגמה, רשומה לדוגמה ביומן שמתארת בקשת API ליצירת מכונה וירטואלית נראית כך:

{
  "log": "compute.googleapis.com/activity_log",
  "insertId": "2015-09-16|13:49:42.532185-07|10.106.9.208|335899593",
  "metadata": {
    "severity": "INFO",
    "projectId": "835469197146",
    "serviceName": "compute.googleapis.com",
    "zone": "us-central1-f",
    "labels":{
      "compute.googleapis.com/resource_id":"0",
      "compute.googleapis.com/resource_name":"example-instance",
      "compute.googleapis.com/resource_type":"instance",
      "compute.googleapis.com/resource_zone":"us-central1-f"
    },
    "timestamp": "2015-09-16T20:49:42.423637Z"
  },
  "structPayload": {
    "version": "1.2",
    "trace_id": "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e",
    "event_timestamp_us": "1442436582423637",
    "event_type": "GCE_API_CALL",
    "event_subtype": "compute.instances.insert",
    "resource": {
      "type": "instance",
      "name": "example-instance",
      "id": "0",
      "zone": "us-central1-f"
    },
    "actor": {
      "user": "user@example.com"
    },
    "ip_address": "",
    "user_agent": "apitools-client/1.0",
    "request": {
      "url": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances",
      "body": "{
        \"canIpForward\":false,
        \"description\":\"\",
        \"disks\":[{
          \"autoDelete\":true,
          \"boot\":true,
          \"deviceName\":\"example-instance\",
          \"initializeParams\":{
            \"diskSizeGb\":\"10\",
            \"diskType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/diskTypes/pd-standard\",
            \"sourceImage\":\"https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-8-jessie-v20150818\"
          },
          \"mode\":\"READ_WRITE\",
          \"type\":\"PERSISTENT\"
        }],
        \"machineType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/machineTypes/n1-standard-1\",
        \"metadata\":{
          \"items\":[]
        },
        \"name\":\"example-instance\",
        \"networkInterfaces\":[{
            \"accessConfigs\":[{
              \"name\":\"External NAT\",
              \"type\":\"ONE_TO_ONE_NAT\"

            }],
            \"network\":\"https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\"
          }],
        \"scheduling\":{
          \"automaticRestart\":true,
          \"onHostMaintenance\":\"MIGRATE\",
          \"preemptible\":false
        },
        \"serviceAccounts\":[{
          \"email\":\"default\",
          \"scopes\":[
            \"https://www.googleapis.com/auth/devstorage.read_only\",
            \"https://www.googleapis.com/auth/logging.write\"
          ]
        }],
        \"tags\":{
          \"items\":[]
        },
        \"zone\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f\"
      }"
    },
    "operation": {
      "type": "operation",
      "name": "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e",
      "id": "291347737657178184",
      "zone": "us-central1-f"
    }
  }
}

רשומות ביומן הפעילות שהוצאו משימוש

החל מ-1 ביוני 2020, לא יהיה יותר תיעוד של הפעולות הבאות ביומן הפעילות, ולא יהיה להן תחליף: