שימוש ברישום מובנה ביומני build

במאמר הזה מוסבר איך להגדיר את היומנים של Cloud Build לשימוש ברישום מובנה ביומן ב-Cloud Logging.

רישום מובנה ביומן מאפשר לכם לאחסן שדה של יומן בנייה בפורמט JSON כחלק מהשדה jsonPayload או כשדות אחרים מסוימים ב-LogEntry. אתם יכולים להגדיר את קובץ תצורת ה-build כך ששדות ספציפיים ביומן ה-build ימופו באופן הזה כשאתם שולחים יומן build ל-Logging.

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

מיפוי שדות של יומן בניית המפה לשדות של רשומה ביומן

כדי להפעיל מיפוי שדות ביומני הבנייה, צריך להגדיר את השדה BuildOptions enableStructuredLogging לערך TRUE.

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

שדה BuildLog ‏ (JSON)	שדה LogEntry	תיאור	הערות
message	textPayload או jsonPayload.message	מאפשר להגדיר את הודעת היומן	חייב להיות מחרוזת. אם יומן הבנייה מכיל רק שדות שניתן למפות, ההודעה מופיעה ב-textPayload. אחרת, ההודעה תופיע בjsonPayload.message. אם יומן הבנייה מכיל כמה שלבים, מזהה השלב מופיע בתחילת ההודעה.
severity	severity	מאפשר להגדיר את רמת החומרה של היומן.	חייב להיות אחד מהערכים הבאים: LogSeverity.

אי אפשר למפות את השדות הבאים ביומן של גרסת ה-build, והם יוסרו מהרשומה ביומן אם הם יופיעו ביומן של גרסת ה-build:

• httpRequest
• logging.googleapis.com/insertId
• logging.googleapis.com/labels
• logging.googleapis.com/operation
• logging.googleapis.com/sourceLocation
• logging.googleapis.com/spanId
• logging.googleapis.com/trace
• logging.googleapis.com/trace_sampled
• time
• timestamp
• timestampSeconds
• timestampNanos

כל שאר השדות ביומן הבנייה יופיעו כחלק מ-jsonPayload של רשומת היומן.