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

מסוף Cloud de Confiance

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

gcloud

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

gcloud init

REST

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

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

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

מסוף Cloud de Confiance

כדי ליצור קטגוריה ביומן בפרויקט Cloud de Confiance :

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

   כניסה אל Logs Storage

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

2. לוחצים על Create log bucket (יצירת קטגוריה ביומן).

3. מזינים שם ותיאור לקטגוריה.

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

5. אופציונלי: כדי להגדיר שמירה בהתאמה אישית של היומנים בדלי, לוחצים על הבא.

   בשדה תקופת השמירה, מזינים את מספר הימים, בין יום אחד ל-400 days, שבהם רוצים ש-Cloud Logging ישמור את היומנים. אם לא תתאימו אישית את תקופת השמירה, ברירת המחדל תהיה 30 days.

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

6. לוחצים על Create bucket.

   יכול להיות שיעבור קצת זמן עד שהשלבים האלה יושלמו.

gcloud

כדי ליצור קטגוריה ביומן, מריצים את הפקודה gcloud logging buckets create:

gcloud logging buckets create BUCKET_ID --location=LOCATION

לדוגמה, אם רוצים ליצור קטגוריה עם השם BUCKET_ID my-bucket באזור global, הפקודה תיראה כך:

gcloud logging buckets create my-bucket --location global --description "My first bucket"

REST

כדי ליצור קטגוריה, משתמשים בשיטה projects.locations.buckets.create. מכינים את הארגומנטים של השיטה באופן הבא:

1. מגדירים את הפרמטר parent כמשאב שבו רוצים ליצור את הדלי: projects/PROJECT_ID/locations/LOCATION

   המשתנה LOCATION מתייחס לאזור שבו רוצים לאחסן את היומנים.

   לדוגמה, אם רוצים ליצור קטגוריה לפרויקט my-project באזור global, הפרמטר parent ייראה כך: projects/my-project/locations/global

2. מגדירים את הפרמטר bucketId. לדוגמה: my-bucket.

3. מבצעים קריאה לשיטה הסינכרונית projects.locations.buckets.create כדי ליצור את הקטגוריה.

מסוף Cloud de Confiance

נכנסים לדף Logs Storage במסוף Cloud de Confiance :

כניסה אל Logs Storage

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

בטבלה בשם Log buckets מפורטות הקטגוריות שמשויכות לפרויקטCloud de Confiance הנוכחי.

בטבלה מפורטים המאפיינים הבאים של כל קטגוריה ביומן:

• ‫Name: השם של קטגוריה ביומן.
• Description: תיאור של הדלי.
• תקופת השמירה: מספר הימים שבהם נתוני הקטגוריה יישמרו על ידי Cloud Logging.
• אזור: המיקום הגיאוגרפי שבו מאוחסנים הנתונים של הקטגוריה.
• סטטוס: מציין אם הקטגוריה נעולה או לא נעולה.

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

gcloud

מריצים את הפקודה gcloud logging buckets list:

gcloud logging buckets list

אלה המאפיינים שמוצגים לגבי מאגרי היומנים:

• ‫LOCATION: האזור שבו מאוחסנים הנתונים של הקטגוריה.
• ‫BUCKET_ID: השם של קטגוריה ביומן.
• ‫RETENTION_DAYS: מספר הימים שבהם נתוני הקטגוריה יאוחסנו על ידי Cloud Logging.
• ‫LIFECYCLE_STATE: מציין אם הקטגוריה ממתינה למחיקה על ידי Cloud Logging.
• ‫LOCKED: מציין אם הקטגוריה נעולה או לא נעולה.
• ‫CREATE_TIME: חותמת זמן שמציינת מתי נוצר המאגר.
• ‫UPDATE_TIME: חותמת זמן שמציינת מתי הקטגוריה עודכנה בפעם האחרונה.

אפשר גם לראות את המאפיינים של קטגוריה אחת בלבד. לדוגמה, כדי לראות את הפרטים של קטגוריית היומנים _Default באזור global, מריצים את הפקודה gcloud logging buckets describe:

gcloud logging buckets describe _Default --location=global

REST

כדי לראות רשימה של מאגרי היומנים שמשויכים ל Cloud de Confiance פרויקט, משתמשים ב-projects.locations.buckets.list ב-Logging API.

מסוף Cloud de Confiance

נכנסים לדף Logs Storage במסוף Cloud de Confiance :

כניסה אל Logs Storage

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

בקטגוריה ביומן, לוחצים על more_vert More ואז בוחרים באפשרות View bucket details.

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

• שם: השם של קטגוריה ביומן.
• Description: תיאור של קטגוריה ביומן.
• תקופת השמירה: מספר הימים שבהם נתוני הקטגוריה יישמרו על ידי Cloud Logging.
• אזור: המיקום הגיאוגרפי שבו מאוחסנים הנתונים של הקטגוריה.

gcloud

מריצים את הפקודה gcloud logging buckets describe.

לדוגמה, הפקודה הבאה מציגה את הפרטים של הקטגוריה _Default:

gcloud logging buckets describe _Default --location=global

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

• ‫createTime: חותמת זמן שמציינת מתי נוצר המאגר.
• ‫description: תיאור של קטגוריה ביומן.
• ‫lifecycleState: מציין אם הקטגוריה ממתינה למחיקה על ידי Cloud Logging.
• ‫name: השם של קטגוריה ביומן.
• ‫retentionDays: מספר הימים שבהם נתוני הקטגוריה יאוחסנו על ידי Cloud Logging.
• ‫updateTime: חותמת זמן שמציינת מתי הקטגוריה עודכנה בפעם האחרונה.

REST

כדי לראות את הפרטים של קטגוריה ביומן יחיד, משתמשים בפקודה projects.locations.buckets.get ב-Logging API.

מסוף Cloud de Confiance

כדי לעדכן את המאפיינים של הדלי:

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

   כניסה אל Logs Storage

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

2. לוחצים על more_vert אפשרויות נוספות לצד הדלי שרוצים לעדכן.

3. לוחצים על עריכת מאגר.

4. עורכים את ה-bucket לפי הצורך.

5. לוחצים על עדכון מאגר.

gcloud

כדי לעדכן את המאפיינים של הקטגוריה, מריצים את הפקודה gcloud logging buckets update:

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

לדוגמה:

gcloud logging buckets update my-bucket --location=global --description "Updated description"

REST

כדי לעדכן את המאפיינים של הדלי, משתמשים ב-projects.locations.buckets.patch ב-Logging API.

מסוף Cloud de Confiance

כדי לעדכן את תקופת השמירה של מאגר יומנים:

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

   כניסה אל Logs Storage

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

2. בקטגוריה שרוצים לעדכן, לוחצים על more_vert More ואז על Edit bucket.

3. בשדה Retention (שמירה), מזינים את מספר הימים שרוצים ש-Cloud Logging ישמור את היומנים, בין יום אחד ל-400 daysימים.

4. לוחצים על עדכון מאגר. תקופת השמירה החדשה מופיעה ברשימה Logs bucket.

gcloud

כדי לעדכן את תקופת השמירה של קטגוריית יומנים שהוגדרה על ידי המשתמש או של קטגוריית היומנים _Default שנמצאת בפרויקט, מריצים את הפקודה gcloud logging buckets update אחרי שמגדירים ערך ל-RETENTION_DAYS:

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

לדוגמה, כדי לשמור את היומנים בקטגוריה _Default במיקום global למשך שנה, הפקודה תיראה כך:

gcloud logging buckets update _Default --location=global --retention-days=365

מסוף Cloud de Confiance

במסוף Cloud de Confiance אין תמיכה בנעילת מאגר יומנים.

gcloud

כדי לנעול את הקטגוריה, מריצים את הפקודה gcloud logging buckets update עם הדגל --locked:

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

לדוגמה:

gcloud logging buckets update my-bucket --location=global --locked

REST

כדי לנעול את המאפיינים של הקטגוריה, משתמשים ב-projects.locations.buckets.patch ב-Logging API. מגדירים את הפרמטר locked לערך true.

מסוף Cloud de Confiance

כדי למחוק קטגוריה ביומן:

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

   כניסה אל Logs Storage

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

2. מוצאים את ה-bucket שרוצים למחוק ולוחצים על more_vertאפשרויות נוספות.

   1. בוחרים באפשרות מחיקת קטגוריה.

   2. בחלונית האישור, לוחצים על מחיקה.

   3. בדף Logs Storage (אחסון יומנים), בדלי מופיע אינדיקטור שמציין שהוא ממתין למחיקה. המאגר, כולל כל היומנים שבו, יימחק אחרי 7 ימים.

   gcloud

   כדי למחוק קטגוריית יומנים, מריצים את הפקודה gcloud logging buckets delete:

   gcloud logging buckets delete BUCKET_ID --location=LOCATION

   REST

   כדי למחוק קטגוריה, משתמשים ב-projects.locations.buckets.delete ב-Logging API.

   שחזור של קטגוריה שנמחקה

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

   מסוף Cloud de Confiance

   כדי לשחזר קטגוריה ביומן שממתינה למחיקה:

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

      כניסה אל Logs Storage

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

   2. ליד הקטגוריה שרוצים לשחזר, לוחצים על more_vert More ואז על Restore deleted bucket.

   3. בחלונית האישור, לוחצים על שחזור.

   4. בדף Logs Storage, האינדיקטור של המחיקה בהמתנה מוסר מקטגוריית היומנים.

   gcloud

   כדי לשחזר קטגוריה ביומן שממתינה למחיקה, מריצים את הפקודה gcloud logging buckets undelete:

   gcloud logging buckets undelete BUCKET_ID --location=LOCATION

   REST

   כדי לשחזר קטגוריה שממתינה למחיקה, משתמשים ב-projects.locations.buckets.undelete ב-Logging API.

   קריאה וכתיבה של רשומות ביומן

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

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

   כדי לקרוא יומנים מקטגוריית יומנים:

   מסוף Cloud de Confiance

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

      כניסה אל Logs Explorer

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

   2. כדי להתאים אישית את היומנים שמוצגים ב-Logs Explorer, לוחצים על Refine scope (צמצום ההיקף) ובוחרים באחת מהאפשרויות. לדוגמה, אפשר להציג יומנים שמאוחסנים בפרויקט או לפי תצוגת יומן.

   3. לוחצים על אישור. החלונית Query results נטענת מחדש עם יומנים שתואמים לאפשרות שבחרתם.

   מידע נוסף זמין במאמר בנושא סקירה כללית על Logs Explorer: צמצום היקף.

   gcloud

   כדי לקרוא יומנים מקטגוריה ביומן, משתמשים בפקודה gcloud logging read ומוסיפים LOG_FILTER כדי לבחור נתונים:

   gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=LOG_VIEW_ID

   REST

   כדי לקרוא יומנים מקטגוריית יומנים, משתמשים בשיטה entries.list. מגדירים את resourceNames כדי לציין את הקטגוריה ואת תצוגת היומן המתאימות, ומגדירים את filter כדי לבחור נתונים.

   מידע מפורט על תחביר הסינון זמין במאמר בנושא שפת השאילתות של Logging.

   פתרון בעיות נפוצות

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

   למה אי אפשר למחוק את ה-bucket הזה?

   אם אתם מנסים למחוק קטגוריה, אתם צריכים:

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

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

   אילו חשבונות שירות מעבירים יומנים אל הדלי שלי?

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

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

      כניסה לדף IAM

      אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שמופיע בה הכותרת המשנית IAM & Admin.

   2. בכרטיסייה Permissions (הרשאות), בוחרים באפשרות Roles (תפקידים). מוצגת טבלה עם כל התפקידים והמשתמשים ב-IAM שמשויכים לפרויקטCloud de Confiance .

   3. בתיבת הטקסט Filter של הטבלה filter_list, מזינים Logs Bucket Writer.

      מוצגים כל חשבונות המשתמשים עם התפקיד כתיבה בדלי יומנים. אם חשבון המשתמש הוא חשבון שירות, המזהה שלו מכיל את המחרוזת s3ns-system.iam.gserviceaccount.com.

   4. אופציונלי: אם רוצים להסיר חשבון שירות מהאפשרות לנתב יומנים לפרויקט Cloud de Confiance , מסמנים את תיבת הסימון check_box_outline_blank של חשבון השירות ולוחצים על הסרה.

   למה אני רואה יומנים של Cloud de Confiance פרויקט מסוים למרות שהחרגתי אותם ממאגר הנתונים _Defaultשלי?

   יכול להיות שאתם צופים ביומנים בקטגוריה ביומן בפרויקט Cloud de Confiance מרכזי, שבו היומנים מכל הארגון מרוכזים.

   אם אתם משתמשים ב-Logs Explorer כדי לגשת ליומנים האלה ולראות יומנים שהחרגתם מ_Defaultה-sink, יכול להיות שהתצוגה מוגדרת לCloud de Confiance רמת הפרויקט.

   כדי לפתור את הבעיה הזו, בוחרים באפשרות Log view בתפריט Refine scope, ואז בוחרים את תצוגת היומן שמשויכת לדלי _Default בפרויקטCloud de Confiance . היומנים שהוחרגו לא אמורים להופיע יותר.

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

   מידע על שיטות ה-API של קטגוריה ביומן מופיע במאמרי העזרה של LogBucket.

   אם אתם מנהלים ארגון או תיקייה, אתם יכולים לציין את המיקום של מאגרי היומנים _Default ו-_Required של משאבי צאצא. אפשר גם להגדיר אם מאגרי יומנים ישתמשו ב-CMEK ואת ההתנהגות של _Default sink ביומן. מידע נוסף מופיע במאמר בנושא קביעת הגדרות ברירת מחדל לארגונים ולתיקיות.

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

   • צבירה ואחסון של היומנים של הארגון.
   • הגדרת אזור ליומנים.