צפייה בהיסטוריית המשימות דרך אירועי הסטטוס

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

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

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

  1. אם עוד לא השתמשתם ב-Batch, כדאי לעיין במאמר תחילת העבודה עם Batch ולהפעיל את Batch על ידי השלמת הדרישות המוקדמות לפרויקטים ולמשתמשים.

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

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

צפייה באירועי סטטוס

יכול להיות שאירועי סטטוס שונים יופיעו ברמת המשימה (שדה statusEvents[] של המשימה) וברמת הפעולה (שדה statusEvents[] של כל פעולה).

בהוראות הבאות מוסבר איך לראות אירועי סטטוס באמצעותGoogle Cloud המסוף, ה-CLI של gcloud ו-Batch API. כדי להשתמש בשפה של ספריית לקוח, מבצעים את השלבים להצגת פרטים של משרה או להצגת פרטים של משימה, ואז מעיינים בשדה statusEvents[] המתאים.

צפייה באירועי הסטטוס של משימה

המסוף

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

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

    מעבר לרשימת המשימות

  2. בעמודה Job name (שם המשימה), לוחצים על שם המשימה.

    ייפתח הדף פרטי המשרה.

    הכרטיסייה פרטים פתוחה כברירת מחדל.

  3. לוחצים על הכרטיסייה אירועים.

gcloud

כדי לראות את אירועי הסטטוס של משימה באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud batch jobs describe ואז בודקים את השדה statusEvents[].

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫JOB_NAME: השם של משימה קיימת.

  • ‫LOCATION: המיקום שבו המשימה קיימת.

API

כדי להציג את אירועי הסטטוס של משימה באמצעות Batch API, שולחים בקשת GET לשיטה jobs.get ואז מעיינים בשדה statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של הפרויקט הנוכחי.

  • ‫LOCATION: המיקום שבו המשימה קיימת.

  • ‫JOB_NAME: השם של משימה קיימת.

צפייה באירועי הסטטוס של משימה

gcloud

כדי להציג את אירועי הסטטוס של משימה באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud batch tasks describe ואז בודקים את השדה statusEvents[].

gcloud batch tasks describe TASK_INDEX \
  --location=LOCATION \
  --job=JOB_NAME \
  --task_group=TASK_GROUP_NAME

מחליפים את מה שכתוב בשדות הבאים:

  • ‫TASK_INDEX: האינדקס של המשימה שרוצים לראות את הפרטים שלה. בקבוצת משימות, אינדקס המשימות מתחיל ב-0 עבור המשימה הראשונה וגדל ב-1 עם כל משימה נוספת. לדוגמה, לקבוצת משימות שמכילה ארבע משימות יש את האינדקסים 0, 1, 2 ו-3.

  • ‫JOB_NAME: השם של משימה קיימת.

  • ‫LOCATION: המיקום שבו המשימה קיימת.

  • ‫TASK_GROUP_NAME: השם של קבוצת המשימות שמכילה את המשימה שרוצים לראות את הפרטים שלה. הערך חייב להיות group0.

API

כדי להציג את אירועי הסטטוס של משימה באמצעות Batch API, שולחים בקשת GET לשיטה tasks.get ואז מעיינים בשדה statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של הפרויקט הנוכחי.

  • ‫LOCATION: המיקום שבו המשימה קיימת.

  • ‫JOB_NAME: השם של משימה קיימת.

  • ‫TASK_GROUP_NAME: השם של קבוצת המשימות שמכילה את המשימה שרוצים לראות את הפרטים שלה. הערך חייב להיות group0.

  • ‫TASK_INDEX: האינדקס של המשימה שרוצים לראות את הפרטים שלה. בקבוצת משימות, אינדקס המשימות מתחיל ב-0 עבור המשימה הראשונה וגדל ב-1 עם כל משימה נוספת. לדוגמה, לקבוצת משימות שמכילה ארבע משימות יש את האינדקסים 0, 1, 2 ו-3.

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