שליחת יומני ביצוע אל Cloud Logging

‫Workflows יוצר באופן אוטומטי יומני ביצוע עבור ביצועים של תהליכי עבודה ב-Cloud Logging.

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

פרטים נוספים, כולל קובצי הפרוטוקול של engine_call ו-executions_system, זמינים במאגר הזה ב-GitHub.

יומני ביצוע

כל ביצוע של תהליך עבודה מפעיל אוטומטית לפחות שני יומני ביצוע: אחד בתחילת הביצוע ואחד בסופו.

מידע נוסף על יומנים של פלטפורמת Workflows שזמינים ב-Logging מפורט במאמר בנושא Google Cloud יומנים של פלטפורמה.

יומן שיחות

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

רק שלבים מפורשים של קריאה לפונקציה נרשמים ביומן. לדוגמה, קריאות לפונקציות של תת-תהליכי עבודה או של ספריות. שיחות מתוך ביטויים, או מתוך פונקציות בספרייה רגילה (לדוגמה, http.post ב-sys.log), ומתוך מחברים לא נרשמות ביומן.

כותרות בקשת HTTP‏ Authorization מושמטות מהיומנים של קריאות HTTP.

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

חשוב לזכור שהמגבלה על גודל רשומת היומן שמוגדרת על ידי Cloud Logging חלה גם על יומן השיחות.

יומנים בהתאמה אישית

כדי ליצור רשומה ביומן ב-Logging במהלך הרצת תהליך עבודה, צריך להגדיר שלב בתהליך העבודה שמבצע קריאה לפונקציה של הספרייה הרגילה sys.log:

  - step1:
      assign:
          - varA: "Hello"
          - varB: "World"
  - logStep:
      call: sys.log
      args:
          text: TEXT
          severity: SEVERITY 
  - step2:
      return: ${varA + " " + varB}
    

    [
      {
        "step1": {
          "assign": [
            {
              "varA": "Hello"
            },
            {
              "varB": "World"
            }
          ]
        }
      },
      {
        "logStep": {
          "call": "sys.log",
          "args": {
            "text": "TEXT",
            "severity": "SEVERITY"
          }
        }
      },
      {
        "step2": {
          "return": "${varA + " " + varB}"
        }
      }
    ]
      

כשיוצרים רשומה ביומן, מגדירים את הפרטים הבאים:

• ‫TEXT: חובה. הטקסט שיירשם ביומן. אם אתם צריכים לרשום ביומן את הערכים של מיפוי, השתמשו ב-${json.encode_to_string(myMap)}.
• ‫SEVERITY: אופציונלי. רמת החומרה של רשומת היומן. לדוגמה, INFO,‏ WARNING או CRITICAL.

מידע נוסף זמין במאמר sys.log הסבר על פונקציות.

ההרשאות הנדרשות

כדי להחיל רישום של שיחות או לשלוח יומנים בהתאמה אישית אל Logging, צריך לשייך את תהליך העבודה לחשבון שירות שכולל את ההרשאה logging.logEntries.create (לדוגמה, התפקיד roles/logging.logWriter). אם אתם צריכים לשנות את חשבון השירות שמעודכן בתהליך העבודה, תוכלו לעיין במאמר בנושא עדכון תהליך עבודה. מידע נוסף על יצירת חשבונות שירות והקצאת תפקידים מופיע במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים.

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

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

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

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

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

   כניסה לדף Workflows

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

3. כדי לראות את היומנים, לוחצים על יומנים.

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

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

• יומנים שנשלחו לרישום ביומן

• יומני ביקורת של כל הפעולות שבוצעו בתהליך העבודה, כמו עדכונים להגדרה של תהליך העבודה

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

כדי לראות את היומנים ב-Logging:

1. במסוף Google Cloud , נכנסים לדף Logs Explorer:
   

   כניסה לדף Logs Explorer

2. בכלי ליצירת שאילתות, לוחצים על Resource ומזינים workflow. בוחרים באפשרות Cloud Workflow (תהליך עבודה בענן) מהרשימה ולוחצים על Add (הוספה).

   

3. לוחצים על Run query.

מידע נוסף על הצגת יומנים ב-Logging זמין במאמר שימוש ב-Logs Explorer.

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

• גישה לתוצאות של ביצוע תהליך העבודה
• פתרון בעיות