באמצעות Cloud Monitoring API ו-Google Cloud CLI, אתם יכולים ליצור ולנהל באופן פרוגרמטי את ערוצי ההתראות שבהם Cloud Monitoring משתמש כדי להודיע לכם או לצוות התמיכה שלכם כשמופעלת מדיניות התראות. באמצעות ספריות לקוח או Google Cloud CLI, יוצרים ערוצי התראות מתוך תיאורים מובנים של ערוצי התראות, ואז מפנים לערוצים האלה במדיניות ההתראות.
כדי להגדיר ערוצי התראות במסוף Google Cloud , אפשר לעיין במאמר בנושא יצירה וניהול של ערוצי התראות. דוגמאות הקוד במסמך הזה מגיעות מהדוגמה של API של מדיניות התראות בדוגמה: גיבוי ושחזור.
מידע על ה-API
המשאב NotificationChannel תומך בפעולות שמאפשרות לכם לנהל את ערוצי ההתראות. הוא תומך גם בפעולות שקשורות לניהול השדה verificationStatus של ערוץ:
- שליחת קוד אימות
- יצירת קוד להעתקת סטטוס האימות של ערוץ מאומת לערוצים זהים אחרים באותו פרויקט או בפרויקט חדש
- אימות הערוץ באמצעות הקוד שנוצר בשתי הפעולות הקודמות
מידע נוסף זמין במסמכי העיון בנושא notificationChannels.
מגבלות
- סוגי ערוצים שהוצאו משימוש: סוגי הערוצים
campfireו-hipchatהוצאו משימוש. אל תיצרו ערוצים חדשים מהסוגים האלה. - מדיניות אחסון הודעות ב-Pub/Sub: אם מגדירים מדיניות אחסון הודעות או הגבלות על מיקום אחסון הנתונים בנושא ב-Pub/Sub, יכול להיות שלא תהיה ל-Monitoring אפשרות לפרסם בנושא. מידע נוסף זמין במאמר בנושא שגיאה
FAILED_PRECONDITION. - קריאות מקבילות ל-API: כשיוצרים, משנים או מוחקים ערוץ התראות בפרויקט Google Cloud , צריך לתכנן את האפליקציה כך שהיא תפעיל את Cloud Monitoring API משרשור יחיד.
לפני שמתחילים
-
כדי לקבל את ההרשאות שנדרשות להצגה ולהגדרה של ערוצי התראות באמצעות Cloud Monitoring API, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM Monitoring NotificationChannel Editor (
roles/monitoring.notificationChannelEditor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
מידע נוסף על תפקידים ב-Cloud Monitoring זמין במאמר בקרת גישה באמצעות ניהול זהויות וגישה.
-
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
gcloud
במסוף Google Cloud , מפעילים את Cloud Shell.
בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
C#
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של .NET שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
המשך
כדי להשתמש בדוגמאות של Go שבדף הזה בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
Java
כדי להשתמש בדוגמאות של Java שבדף הזה בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
Node.js
כדי להשתמש בדוגמאות של Node.js שבדף הזה בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
א�� מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המא��ר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
PHP
כדי להשתמש בדוגמאות של PHP שבדף הזה בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
Python
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Python שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .
-
אם אתם מתכננים להשתמש ב-Google Cloud CLI, אתם צריכים להגדיר את פרויקט ברירת המחדל:
gcloud config set project PROJECT_IDלפני שמריצים את הפקודה הקודמת, מחליפים את מה שכתוב בשדות הבאים:
- PROJECT_ID: מזהה הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את הפרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
רשימה של סוגי ערוצי התראות
ב-Monitoring יש מספר סוגים מובנים של ערוצי התראות. כל אחד מהסוגים האלה מתואר בNotificationChannelDescriptor.
לכל מתאר יש שדה type שהערך שלו מזהה את סוג הערוץ כשיוצרים מופע של ערוץ. כדי לאחזר רשימה של סוגי ערוצים שאפשר ליצור באמצעות Cloud Monitoring API או Google Cloud CLI, מזינים את הפקודה הבאה:
$ gcloud beta monitoring channel-descriptors list --format='value(type)'
campfire
email
google_chat
hipchat
pagerduty
pubsub
slack
sms
webhook_basicauth
webhook_tokenauth
אם ערוץ ההתראות המועדף שלכם לא נתמך, כדאי ליצור צינור שמתבסס על שליחת ההתראות ל-Pub/Sub. דוגמה ל-Python שמשתמשת ב-Flask זמינה במאמר יצירת התראות בהתאמה אישית באמצעות Cloud Monitoring ו-Cloud Run. דוגמאות נוספות זמינות במאגר cloud-alerting-notification-forwarding Git.
רשימה של כל סוגי הערוצים
כדי לאחזר את כל תיאורי הערוצים ב Google Cloud פרויקט, משתמשים בפקודה gcloud beta monitoring channel-descriptors list או בשיטת ה-API notificationChannelDescriptors.list.
המתארים שאוחזרו הם לקריאה בלבד.
gcloud beta monitoring channel-descriptors list
אם הפקודה list מופעלת בהצלחה, היא מספקת רשימה של כל תיאורי הערוצים בפרויקט שצוין. לדוגמה, תיאור הערוץ email יופיע ברשימה כך:
---
description: A channel that sends notifications via email.
displayName: Email
labels:
- description: An address to send email.
key: email_address
name: projects/[PROJECT_ID]/notificationChannelDescriptors/email
type: email
---
כל תיאורי הערוצים כוללים את השדות הבאים:
-
name: שם המשאב המוגדר במלואו של מתאר הערוץ. -
type: החלק בשם שמציין את סוג הערוץ. -
displayName: תיאור של השדהtype, למטרות תצוגה. -
description: תיאור קצר של הערוץ. -
labels: קבוצה של שדות שספציפיים לסוג הערוץ. לכל סוג ערוץ יש קבוצה משלו של תוויות.
כשיוצרים ערוץ, נוצר גם שדה enabled עם הערך true כברירת מחדל.
הצגת רשימה של סוג ערוץ ספציפי
אם אתם מחפשים תיאור ספציפי ואתם יודעים את השם שלו, אתם יכולים להשתמש ב-gcloud beta monitoring channel-descriptors describe או בשיטת ה-API notificationChannelDescriptors.get. השם של מתאר הערוץ הוא בפורמט projects/[PROJECT_ID]/notificationChannelDescriptors/[CHANNEL_TYPE].
[CHANNEL_TYPE] חייב להיות אחד מהסוגים שצוינו קודם. לדוגמה:
gcloud beta monitoring channel-descriptors describe email
gcloud beta monitoring channel-descriptors describe projects/[PROJECT_ID]/notificationChannelDescriptors/email
מידע נוסף זמין במאמרים בנושא gcloud beta monitoring channel-descriptors list וdescribe. הפקודה describe תואמת ל-method notificationChannelDescriptors.get ב-API.
יצירת ערוץ התראות
אפשר ליצור ערוצי התראות עבור פרויקטים ב- Google Cloud באמצעות קובצי JSON או YAML באמצעות Google Cloud CLI, ואפשר גם ליצור אותם באופן פרוגרמטי.
כדי ליצור ערוץ התראות, צריך לספק ערכים לשדות בתיאור שלו. רובם, כמו type, נפוצים בכל תיאורי ערוצי ההתראות. אפשר לעיין בnotificationChannelDescriptors.
לכל תיאור יש גם קבוצה של תוויות, והקבוצה הזו משתנה בין התיאורים. כדי לראות את קבוצת התוויות של מתאר מסוים, מאחזרים את המתאר באמצעות הפקודה gcloud beta monitoring channel-descriptors describe שמתוארת במאמר רשימת הסוגים של ערוצי התראות.
לדוגמה, כשמאחזרים את תיאור הערוץ email מוצגת תווית אחת:
labels:
- description: An address to send email.
key: email_address
תיאור הערוץ pubsub מכיל גם תווית אחת שמזהה את נושא ה-Pub/Sub. עם זאת, ערוצים יכולים להכיל כמה תוויות. לדוגמה, לתיאור הערוץ slack יש שתי תוויות:
labels:
- description: A permanent authentication token provided by Slack. This field is obfuscated by returning only a few characters of the key when fetched.
key: auth_token
- description: The Slack channel to which to post notifications.
key: channel_name
כשמאחזרים את webhook_basicauth תיאור הערוץ מוצגות כמה תוויות:
labels:
- description: The password. The field is obfuscated when the channel is fetched.
key: password
- description: The public URL to which to publish the webhook.
key: url
- description: The username.
key: username
בין אם יוצרים ערוץ חדש באופן פרוגרמטי או משורת הפקודה, הערך של type במפרט צריך להיות זהה לערך בשדה type בתיאור המתאים של ערוץ ההתראות. גם מפתחות התוויות הנדרשים צריכים להיות זהים לאלה שבתיאור הערוץ.
חלק מהתוויות תואמות לפרטי הכניסה שמשמשים לאימות מול הספק. כשיוצרים ערוץ, צריך לקבל את הערכים של התוויות האלה מהספק. כדי לקבל פרטי כניסה, יכול להיות שתצטרכו להשתמש בדף ליצירת מפתח API באתר של הספק או להשלים תהליך התחברות באמצעות OAuth אצל הספק. הפרטים הספציפיים לגבי קבלת פרטי כניסה כאלה תלויים בספק המסוים.
הערוצים מופעלים כברירת מחדל. אם רוצים ליצור ערוץ לא פעיל, אפשר לכלול את השדה enabled עם הערך false.
בדוגמאות הבאות מוסבר איך ליצור ערוצי התראות.
דוגמה: יצירת ערוץ התראות Pub/Sub באמצעות ה-CLI של gcloud
כדי ליצור ערוץ התראות בפרויקט Google Cloud , משתמשים בפקודה gcloud beta monitoring channels create. כדי לטעון את הערוץ מקובץ, משתמשים בדגל --channel-content-from-file כדי לציין את הקובץ.
לדוגמה, הקטע הבא מציג את ההגדרה של ערוץ התראות חדש pubsub ב-JSON:
{
"type": "pubsub",
"displayName": "Notifications",
"description": "Pub/Sub channel for notifications",
"labels": {
"topic": "projects/[PROJECT_ID]/topics/notificationTopic"
},
}
הערך type (pubsub) ומפתח התווית היחיד (topic) תואמים לשדות type ו-labels.key בתיאור הערוץ המתאים.
בדוגמה הבאה נוצר ערוץ Pub/Sub חדש מקובץ pubsub-channel.json:
gcloud beta monitoring channels create --channel-content-from-file="pubsub-channel.json"
אם הפקודה מסתיימת ללא שגיאות, היא מחזירה את השם של הערוץ החדש. לדוגמה:
Created notification channel [projects/[PROJECT_ID]/notificationChannels/1355376463305411567].
כשיוצרים pubsub ערוץ התראות, חשוב לתת לחשבון השירות של שירות ההתראות הרשאה לפרסם בנושא. חשוב גם לזכור שאם לנושא יש מדיניות אחסון הודעות או הגבלות על מיקום הנתונים, יכול להיות שהכלי לניטור לא יוכל לפרסם בו. מידע נוסף זמין במאמר בנושא שגיאה FAILED_PRECONDITION.
דוגמה: יצירת ערוץ התראות באמצעות ספריות לקוח
בדוגמאות הבאות מוצגות דרכים ליצור ערוץ התראות באמצעות ספריית לקוח:
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
דוגמה: יצירת ערוץ התראות ב-Slack
כדי להגדיר ערוץ התראות לאפליקציית Slack:
מגדירים את אפליקציית Slack:
- אם עדיין אין לכם אפליקציית Slack, אתם יכולים ליצור אחת ולהתקין אותה במרחב העבודה שלכם לפי ההוראות במסמכי העזר של Slack.
- מגדירים את אפליקציית Slack עם היקף הרשאות ל-OAuth עבור
chat:writeו-chat:write.public. - מעתיקים את טוקן ה-OAuth של משתמש הבוט של האפליקציה.
יוצרים קובץ שמגדיר את התצורה של ערוץ ה��תראות. כול��י�� ��ו��ית שבה למפתח
auth_tokenיש את הערך של טוקן הגישה ל-OAuth של משתמש הבוט באפליקציית Slack. לדוגמה:{ "description": "A Slack notification channel", "displayName": "Slack", "type": "slack", "enabled": true, "labels": { "auth_token": "OAUTH_TOKEN_VALUE", "channel_name": "SLACK_CHANNEL_NAME" } }מריצים את הפקודה הבאה כדי ליצור את ערוץ ההתראות:
gcloud beta monitoring channels create --channel-content-from-file="FILE_NAME"
הצגת רשימה של ערוצי התראות בפרויקט
כדי לאחזר את כל ערוצי ההתראות ב Google Cloud פרויקט, משתמשים ב-method notificationChannels.list. השיטה הזו תומכת גם באפשרויות filter ו-orderBy להגבלת התוצאות ולמיון שלהן. מידע נוסף זמין במאמר בנושא מיון וסינון.
אם אתם מחפשים ערוץ ספציפי ואתם יודעים את השם שלו,
אתם יכולים להשתמש בשיטה notificationChannels.get כדי לאחזר רק את הערוץ הזה. הפורמט של שם הערוץ הוא
projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]. לדוגמה:
projects/[PROJECT_ID]/notificationChannels/1355376463305411567
כשמאחזרים ערוץ, יכול להיות שערכים רגישים כמו אסימוני אימות ומפתחות API יוסתרו מטעמי אבטחה. אם אתם יוצרים ערוץ חדש על ידי העתקה של ערוץ קיים, צריך לתקן את כל הערכים המוסתרים.
gcloud
כדי להציג רשימה של כל ערוצי ההתראות בפרויקט Google Cloud , משתמשים בפקודה gcloud beta monitoring channels list:
gcloud beta monitoring channels list
אם הפקודה list מסתיימת ללא ש��י��ות, ��יא מחזירה רשימה של כל הערוצים בפרויקט שצוין. לדוגמה, הפקודה הקודמת עשויה להחזיר רשימה שכוללת את הרשומות הבאות:
---
description: E-mail channel created by gcloud as a test
displayName: test e-mail channel
enabled: false
labels:
email_address: user@example.com
name: projects/[PROJECT_ID]/notificationChannels/1355376463305411567
type: email
---
description: Pub/Sub channel for notifications
displayName: Notifications
enabled: true
labels:
topic: projects/[PROJECT_ID]/topics/notificationTopic
name: projects/[PROJECT_ID]/notificationChannels/1355376463305411567
type: pubsub
כדי להציג ערוץ יחיד, משתמשים בתג gcloud beta monitoring channels describe ומציינים את שם הערוץ.
לדוגמה, הפקודה הזו מחזירה את ערוץ Pub/Sub שמוצג ברשימה הקודמת:
gcloud beta monitoring channels describe projects/[PROJECT_ID]/notificationChannels/1355376463305411567
מידע נוסף זמין במאמרים בנושא gcloud beta monitoring channels list וdescribe. הפקודה describe תואמת ל-method notificationChannels.get ב-API.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקת ערוץ התראות מפרויקט
כדי למחוק ערוץ התראות מ Google Cloud פרויקט, משתמשים בשיטה notificationChannels.delete ומזינים את השם של ערוץ ההתראות שרוצים למחוק. השם של הערוץ הוא הערך של השדה name, ולא של displayName, במופע NotificationChannel.
הפורמט של שם הערוץ הוא
projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]. לדוגמה:
projects/[PROJECT_ID]/notificationChannels/1355376463305411567
כברירת מחדל, אם תנסו למחוק ערוץ שמופיע בהפניה במדיניות התראות, הערוץ לא יימחק. כדי לכפות את ההסרה של הפניות ממדיניות ההתראות ולמחוק את הערוץ, מגדירים את האפשרות force לערך true. האפשרות הזו מסירה באופן אוטומטי את הערוץ מכל המדיניות שמפנה אליו.
gcloud
כדי למחוק ערוץ התראות, משתמשים בפקודה gcloud beta monitoring channels
delete ומציינים את שם הערוץ שרוצים למחוק. לדוגמה, הפקודה הבאה מוחקת את הערוץ email שנוצר בדוגמה אחרת:
gcloud beta monitoring channels delete projects/[PROJECT_ID]/notificationChannels/1355376463305411567
מידע נוסף מופיע במפרט של השיטה ב-gcloud beta monitoring channels delete.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
שינוי של ערוץ התראות
כדי לשנות ערוץ התראות, משתמשים ב-method notificationChannels.patch (ב-API בארכיטקטורת REST).
הטמעות אחרות של API ו-Google Cloud CLI קוראות ל-update במקום ל-patch.
פעולת עדכון יכולה להחליף לחלוטין את הערוץ הקיים, או לשנות קבוצת משנה של שדות. לדוגמה, אפשר להפעיל ולהשבית את הערוץ. השבתה של ערוץ מונעת את המסירה של התראות לערוץ. השבתה של ערוץ בדרך כלל נוחה יותר מהסרה של הערוץ ממדיניות ההתראות שמפנה אליו, אם השינוי אמור להיות זמני.
gcloud
כדי להפעיל ערוץ התראות ��ושבת, משתמשים בפקודה gcloud beta monitoring channels update ומספקים את הדגל --enabled. הפקודה הבאה מפעילה את ערוץ ההתראות email שנוצר – במצב מושבת – בדוגמה הקודמת:
gcloud beta monitoring channels update projects/[PROJECT_ID]/notificationChannels/1355376463305411567 --enabled
כדי להשבית ערוץ התראות, משתמשים באותה פקודה ומספקים את הדגל --no-enabled.
מידע נוסף זמין במפרט של השיטה ב-gcloud beta monitoring channels update. הפקודה update תואמת ל-method notificationChannels.patch ב-API בארכיטקטורת REST.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
צפייה ביומנים של ערוצי התראות
אפשר להשתמש ב-Logs Explorer כדי לראות שגיאות בערוץ ההתראות:
-
במסוף Google Cloud , נכנסים לדף Logs Explorer:
אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.
מזינים ומריצים את השאילתה. לשאילתות שספציפיות לשגיאות בערוצי התראות, אפשר לעיין במאמר שאילתות ב-Cloud Monitoring.