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

מסוף Cloud de Confiance

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

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. כדי לבחור את אזור האחסון של היומנים, לוחצים על התפריט Select log bucket region ובוחרים אזור.

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

   בשדה Retention period, מזינים את מספר הימים שבהם רוצים ש-Cloud Logging ישמור את היומנים, בין יום אחד ל-400 daysימים. אם לא מתאימים אישית את תקופת השמירה, ברירת המחדל היא 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

כדי ליצור קטגוריה, משתמשים ב-method‏ 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.
• אזור: המיקום הגיאוגרפי שבו מאוחסנים הנתונים של הקטגוריה.
• ‫Status: אם הקטגוריה נעולה או לא נעולה.

אם קטגוריה ממתינה למחיקה על ידי Cloud Logging, הרשומה שלה בטבלה מסומנת בסמל warning 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.

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

• ‫Name: השם של קטגוריית היומנים.
• 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 More בקטגוריה שרוצים לעדכן.

3. לוחצים על עריכת הקטגוריה.

4. עורכים את הקטגוריה לפי הצורך.

5. לוחצים על Update bucket.

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. לוחצים על Update bucket. תקופת השמירה החדשה מופיעה ברשימה 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. מאתרים את הקטגוריה שרוצים למחוק ולוחצים על more_vertMore.

   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 , נכנסים לדף 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

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

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

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

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

   למה אי אפשר למחוק את הקטגוריה הזו?

   כדי למחוק קטגוריית יומנים שמוגדרת על ידי המשתמש:

   • מוודאים שיש לכם את ההרשאות המתאימות למחיקת קטגוריית היומנים. רשימת ההרשאות הנדרשות מופיעה במאמר בקרת גישה באמצעות 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 של חשבון השירות ולוחצים על Remove.

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

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

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

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

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

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

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

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

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