בדף הזה מוסבר איך להפעיל את Monitoring API v3 ולאשר את השימוש בו. כדי להשתמש ב-API הזה, צריך להפעיל אותו.
הפעלת Monitoring API
כדי להפעיל את Monitoring API, משתמשים במסוף Google Cloud או ב-Google Cloud CLI.
המסוף
מפעילים את Cloud Monitoring API.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
gcloud
מפעילים את Cloud Monitoring API:
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
gcloud services enable monitoring.googleapis.com
הרשאת שימוש ב-Monitoring API
הגישה אל Monitoring API נשלטת על ידי תפקידים והרשאות בניהול הזהויות והרשאות הגישה (IAM). לכל method משויכת הרשאה, וההרשאות של methods קשורות מקובצות בתפקידים שאפשר להקצות למשתמשים. מידע נוסף זמין במאמר בקרת גישה באמצעות IAM.
אחרי שמאשרים גישה ל-API, אפשר להשתמש ב-API מכל מקום.
לדוגמה, אפשר להפעיל את השיטה timeSeries.list מתחנת העבודה המקומית. אפשר גם להשתמש ב-API כדי לשלוח מדדים לגבי כל ישות שאפשר לייצג כמשאב במעקב.
במאמר סוגי משאבים במעקב למדדים מוגדרים על ידי המשתמש מופיעה רשימה של הסוגים הזמינים.
אם אתם כותבים אפליקציה שמשתמשת בספריות הלקוח המומלצות, הספריות האלה מאשרות את האפליקציה באמצעות Application Default Credentials.
במקרים מסוימים אפשר גם להשתמש במפתחות API, אבל בדרך כלל מומלץ להשתמש בחשבונות שירות. מפתחות API שימושיים בלקוחות כמו דפדפנים ואפליקציות לנייד שאין להם שרת קצה עורפי. מידע נוסף זמין במאמר שימוש במפתחות API.
מידע נוסף על אימות והרשאה זמין במדריך האימות.