הצגת יומני הביצוע

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

הערה: ב-Application Integration, יומני ההפעלה של אינטגרציה נשמרים לתקופה מקסימלית של 32 ימים.

הצגת יומני הביצוע של השילוב

אפשר לראות את יומני ההפעלה במסוף Google Cloud או באמצעות ה-API.

הערה: אם הגודל של יומני הביצוע גדול מ-300MB, ‏ Application Integration מקפיץ את השגיאה Response size too large והיומנים לא נטענים בדף Execution Logs. במקרה כזה, צריך להשתמש ב-method‏ projects.locations.integrations.executions.list כמו שמוסבר בכרטיסייה API.

המסוף

כדי להציג את יומני הביצוע במסוף Google Cloud :

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

   כניסה ל-Application Integration

2. בתפריט הניווט, לוחצים על יומנים.

   הדף Execution Logs מופיע עם רשימה של יומני ההרצה שנוצרו בשביל השילובים באזור ברירת המחדל. המאפיינים הבאים מוצגים לכל הודעה ביומן ההפעלה:

   • שם השילוב: שם השילוב.
   • מזהה הרצה: מזהה ייחודי שנוצר לכל הרצה של אינטגרציה.
   • סטטוס: סטטוס ההפעלה של השילוב.
     • בתהליך: השילוב מתבצע כרגע.
     • הצליח: מציין שהשילוב בוצע בהצלחה.
     • נכשל: השילוב לא בוצע.
     • ‫Canceled: מציין שהמשתמש ביטל את הפעלת האינטגרציה.
     • בהמתנה: מציין שהפעלת השילוב מושהית באופן זמני וממתינה להשלמת אירוע או פעולה.
     • Retry on hold: מציין שהפעלת האינטגרציה נכשלה והיא ממתינה לניסיון חוזר.
     • בהשעיה: מציין שהפעלת השילוב מושהית באופן זמני ונדרשת התערבות ידנית כדי להמשיך את השילוב.
   • שעת ההתחלה: חותמת הזמן של תחילת ההפעלה של האינטגרציה.
   • ‫Duration: משך הזמן שלוקח להריץ את האינטגרציה.
     הערה: אל תשתמשו בערך Duration כדי לחשב את זמן האחזור של ביצוע מקצה לקצה של אינטגרציה. הזמן שמוצג בעמודה Duration לא משקף את זמן הביצוע הכולל של האינטגרציה, כי הוא לא כולל את הזמן הנוסף שלוקח לאינטגרציה לפני או אחרי הביצוע שלה. לדוגמה, הזמן שלוקח לאכוף את המכסה או לאמת את הבקשה לא נכלל בערך של Duration.
   • גרסת השילוב: גרסת השילוב שהופעלה.
   • מזהה הטריגר: ערך המזהה של הטריגר.
   • ‫Cloud Logging: מציין אם השילוב מוגדר לרישום ביומן ב-Cloud Logging. אם Cloud Logging מופעל, השדה הזה מספק קישור לצפייה ביומנים ב-Cloud Logging. אם Cloud Logging לא מופעל, השדה הזה מוגדר כ-Disabled.
   • הופעל מחדש מ: אם הפעלת האינטגרציה מופעלת מחדש, השדה הזה מספק את מזהה ההפעלה של ההפעלה שהופעלה מחדש. אתם יכולים להפעיל מחדש הרצה של אינטגרציה שפורסמה אם אתם רוצים להריץ מחדש אינטגרציה עם אותם פרמטרים כמו בהרצה הקודמת. לדוגמה, אתם יכולים להפעיל מחדש הרצה אם האינטגרציה נכשלה בגלל שגיאת זמן קצוב לתפוגה, או אם הפלט של האינטגרציה לא תואם לציפיות. במאמר הפעלה מחדש של הרצות מוסבר איך להפעיל מחדש הרצות.

3. כדי לראות את יומני ההרצה של אזור ספציפי, משנים את האזור ברשימה Region.
4. אפשר גם ללחוץ על refresh Refresh Logs כדי לטעון מחדש את רשימת היומנים הנוכחית.

   בתמונה הבאה מוצג דף לדוגמה של Execution Logs ב-Application Integration.

   

API

אם הגודל של יומני ההפעלה גדול מ-300MB, ‏ Application Integration מחזיר את השגיאה Response too large error והיומנים לא נטענים בדף Execution Logs. במקרה כזה, צריך להשתמש ב-projects.locations.integrations.executions.list כדי לקבל את היומנים. כדי להציג יומנים באמצעות ה-API, מבצעים את השלבים הבאים:

1. כדי לקבל את מזהה ההרצה של יומני ההרצה שרוצים להציג, יוצרים בקשת GET באמצעות ה-method‏ projects.locations.integrations.executions.list, כשהפרמטר snapshotMetadataWithoutParams מוגדר ל-TRUE:

   curl -v -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
       -d "snapshotMetadataWithoutParams=true"
   

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

   • ‫PROJECT_ID: המזהה של הפרויקט בענן של Google.
   • ‫LOCATION: האזור של האינטגרציה.
   • ‫INTEGRATION_NAME: שם האינטגרציה.

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

2. כדי לקבל את יומן ההרצה של מזהה ההרצה, יוצרים בקשת GET באמצעות השיטה projects.locations.integrations.executions.list עם מסנן על מזהה ההרצה שהעתקתם בשלב הקודם:

   curl -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
       --data-urlencode 'filter=execution_id="EXECUTION_ID"'
   

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

   • ‫PROJECT_ID: המזהה של הפרויקט בענן של Google.
   • LOCATION: האזור של האינטגרציה.
   • ‫EXECUTION_ID: מזהה ההפעלה שהועתק מהשלב הקודם.

   בתשובה, אפשר לראות את פרטי היומן בשדה ExecutionDetails.

   לחלופין, במסוף Google Cloud , אפשר לסנן את יומני ההרצה לפי מזהה ההרצה.

דוגמה: סינון היומנים

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

curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=workflow_name!="INTEGRATION_NAME"'

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

• ‫PROJECT_ID: המזהה של הפרויקט בענן של Google.
• LOCATION: האזור של האינטגרציה.
• ‫INTEGRATION_NAME: שם האינטגרציה.

אפשר לסנן לפי השדות הבאים:

• ‫execution_id,‏ workflow_name ו-trigger_id: צריך להקיף את ערכי המחרוזות האלה במירכאות כפולות.
• ‫state: מקבל ערך של מצב ExecutionDetails, כמו FAILED או SUCCEEDED. אל תשתמשו במירכאות (לדוגמה, state=FAILED).
• ‫create_timestamp ו-update_time: דורשים חותמת זמן לפי RFC 3339 ב-UTC, שמסתיימת ב-Z. אל תשתמשו במירכאות (לדוגמה, create_timestamp>=2026-10-01T00:00:00Z).

הצגת פרטי הביצוע של המשימה

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

בדף Execution Logs מוצגת רשימה של יומני ההרצה של האינטגרציה. כל יומן רישום של הפעלה תואם להפעלה ספציפית של האינטגרציה.

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

  

• כדי לראות את יומני הביצוע של תת-אינטגרציה, מרחיבים את שם המשימה ולוחצים על שם תת-האינטגרציה. זה רלוונטי למשימות Call Integration,‏ For Each Parallel,‏ For Each Loop ו-While Loop.

סינון היומנים

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

Integration name:INTEGRATION_NAME:TEST_CASE_NAME.

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

• ‫INTEGRATION_NAME: שם האינטגרציה שמכילה בדיקות פונקציונליות.
• ‫TEST_CASE_NAME: השם של מקרה הבדיקה שאת הרצות הבדיקה שלו רוצים להציג.

לדוגמה: Integration name:example-integration-name:example-test-case.

שימוש ביומנים לפתרון בעיות

בקטע הבא מוסבר איך לפתור בעיות במקרים הבאים:

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

פתרון בעיות בשילוב

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

לדוגמה, אם שילוב נכשל בהפעלה במסגרת זמן מסוימת, אפשר להשתמש בשלבים הבאים כדי לגשת ליומנים ולסנן אותם כדי לפתור את הבעיה:

1. מחפשים או בוחרים את השילוב שרוצים לפתור בו בעיות מהרשימה Integrations ולוחצים כדי לפתוח את עורך השילובים.
2. לוחצים על Logs בסרגל הכלים של עורך השילובים כדי לראות את הודעות היומן.
3. בשדה Execution log filter, בוחרים באפשרות Integration name ומזינים את שם האינטגרציה שרוצים לראות את היומנים שלה.
4. לוחצים על Enter.
5. כדי להציג את האינטגרציות שנכשלו, בשדה Execution log filter בוחרים באפשרות Execution status כדי להציג את רשימת הסטטוסים, ואז בוחרים באפשרות Failed.
6. כדי להציג אינטגרציות שנכשלו בטווח זמן ספציפי, בשדה Execution log filter בוחרים באפשרות Start date after ומזינים את השעה הרצויה בפורמט תקין. אחר כך בוחרים באפשרות תאריך הסיום לפני ומזינים את השעה הרצויה. כברירת מחדל, כמה מסננים משולבים באמצעות התנאי AND.

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

במאמר פתרון בעיות ביומני ביצוע שנכשלו באמצעות AI מוסבר איך לפתור בעיות ביומני ביצוע שנכשלו באמצעות AI.

הצגת חריגים בדוח הקריסות

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

הערה: הפרמטרים של אירועי ההודעות ביומן הביצוע (מחרוזת או JSON) נחתכים במגבלה של 2,000 תווים.

מעקב אחרי כשלים במחברים

אתם יכולים להשתמש בהודעות ביומן הביצוע כדי לפתור בעיות ולעקוב אחרי ביצועים שנכשלו של משימות מחברים. נתוני היומן של משימת מחבר שנכשלה נשמרים באמצעות Cloud Logging, ואפשר לראות אותם ב-Logs Explorer.

הערה: נתוני היומן של משימת מחברים שנכשלה זמינים ב-Logs Explorer רק אם Cloud Logging מופעל לחיבור המתאים ב-Integration Connectors. פרטים נוספים זמינים במאמר הצגת יומני המחבר.

כדי לגשת לנתוני היומן של משימת מחבר שנכשלה מ-Application Integration:

1. עוברים לדף Execution Logs של השילוב הרצוי.
2. מרחיבים את הודעת היומן של ההפעלה שנכשלה, ומאתרים את דוח הקריסות בשורה שמכילה את המשימה שנכשלה ב-Connectors.
3. בעמודה סטטוס, לוחצים על נכשל.

   

הכלי Application Integration מריץ באופן אוטומטי את השאילתה הנדרשת למשימת המחברים שנכשלה, ופותח את הדף Logs Explorer כדי להציג את נתוני יומן הביצוע המפורטים.

כדי לאחזר באופן ידני את נתוני היומן של משימת מחברים שנכשלה, אתם יכולים להריץ את השאילתה הבאה בדף Query של Logs Explorer. מידע נוסף על השימוש ב-Logs Explorer זמין במאמר ממשק Logs Explorer.

פורמט השאילתה

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

דוגמה

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

הורדת היומנים

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

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

1. נכנסים לדף Execution Logs.
2. בשורה שמתאימה להרצת האינטגרציה שאת היומנים שלה רוצים להוריד, לוחצים על (תפריט הפעולות) ובוחרים באפשרות Download.

יומני הביצוע יורדים כקובץ JSON לתיקיית ההורדות שמוגדרת כברירת מחדל בדפדפן.

מגבלה

• אם הרישום ביומן המקומי מושבת בשילוב, לא נוצרים יומני ביצוע בשילוב הזה.

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

• למידע על יומנים ב-Application Integration, קראו את מבוא ליומנים.
• מידע ולמידה על מקרי בדיקה