הגדרת Google Cloud Observability למעקב אחרי אפליקציות מאפשרת לכם לראות ולנתח יומנים, מדדים ונתוני מעקב מהאפליקציות שלכם ב-App Hub בממשק אחד, גם אם נתוני הטלמטריה מאוחסנים בכמה פרויקטים ב- Google Cloud . כדי להגדיר את Google Cloud Observability, צריך להגדיר את היקף הניטור – שכולל את היקף ברירת המחדל של היומנים, היקף המדדים והיקף ברירת המחדל של המעקב – ולהקצות תפקידים ב-IAM. ההגדרה הזו רלוונטית גם אם אתם רושמים אפליקציה קיימת ב-App Hub וגם אם אתם פורסים אפליקציות באמצעות Application Design Center.
כדי להציג התראות שמשויכות לאפליקציה בלוחות הבקרה של Application Monitoring, אתם יכולים גם לשייך את מדיניות ההתראות לאפליקציה ב-App Hub. אם אתם מריצים עומסי עבודה ב-Google Kubernetes Engine ורוצים שבמרכזי הבקרה של "מעקב אחרי אפליקציות" יוצגו אותות הזהב של תעבורת הנתונים ב-HTTP, זמן האחזור ושיעור השגיאות, קראו את המאמר הוספת כלים לאפליקציה לצורך מעקב.
לפני שמתחילים
מזהים את הפרויקט שאת היקף הניראות שלו רוצים להגדיר. הפרויקט הזה הוא אחד מהבאים:
- פרויקט מארח של App Hub.
- פרויקט ניהול ב-App Hub לתחום של פרויקט יחיד.
- פרויקט לניהול App Hub בתיקייה לניהול אפליקציות.
במסמך הזה, כשלא מצוין סוג פרויקט הניהול, משימת ההגדרה חלה על כל פרויקטי הניהול.
כדי להגדיר את היקף הניראות, ודאו שיש לכם את התפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM). תפקידי ה-IAM הנדרשים תלויים בשאלה אם אתם מתכננים ליצור כיור נתונים נצבר, שמאפשר לרכז את האחסון של נתוני היומן.
הגדרת כיור והיקפים
כדי לקבל את ההרשאות שנדרשות להגדרת היקפי התצפית וליצירת sink ביומן נצבר, צריך לבקש מהאדמין להקצות לכם את התפקיד Organization Administrator (
roles/resourcemanager.organizationAdmin) ב-IAM בארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
הגדרת היקפים בלבד
כדי לקבל את ההרשאות שדרושות להגדרת היקף הניראות, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
- עריכת תצפיות (
roles/observability.editor) בפרויקט המארח או בפרויקט הניהול של App Hub - כתיבת הגדרות של יומנים (
roles/logging.configWriter) בפרויקט המארח או בפרויקט הניהול של App Hub - אדמין של Monitoring (
roles/monitoring.admin) בפרויקט המארח או בפרויקט הניהול של App Hub, ובכל פרויקט שרוצים להוסיף להיקף המדדים בפרויקט. - משתמש ב-Cloud Trace (
roles/cloudtrace.user) בפרויקט המארח או בפרויקט הניהול של App Hub - הרשאת צפייה ב-App Hub (
roles/apphub.viewer) בפרויקט המארח או בפרויקט הניהול של App Hub
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
- עריכת תצפיות (
הגדרת היקף הניראות (observability)
היקף הניראות קובע איך דפי ה-Explorer ומרכז הבקרה מחפשים את הנתונים שיוצגו. כל פרויקט ב- Google Cloud מכיל היקף תצפית אחד. אי אפשר להגדיר ישירות את היקף הניראות של הפרויקט. במקום זאת, מגדירים בפרויקט את הפרטים הבאים:
אוסף תצוגות היומן שמוגדר כברירת מחדל
מגדירים את ההיקף הזה כך שכאשר פותחים את הדף Logs Explorer או מציגים את מרכזי הבקרה, מוצגים נתוני היומן של האפליקציה. חשוב לוודא שההיקף הזה כולל את הפרויקטים ואת תצוגות היומנים שבהם מאוחסנים נתוני היומנים של האפליקציה.
היקף המדדים בפרויקט
כדאי להגדיר את ההיקף הזה כדי שהתרשימים, למשל אלה שאתם יוצרים באמצעות הדף Metrics Explorer, ומדיניות ההתראות יוכלו להציג את נתוני המדדים של האפליקציה או לעקוב אחריהם. חשוב לוודא שההיקף הזה כולל את הפרויקטים שבהם מאוחסנים נתוני המדדים של האפליקציה.
היקף המעקב שמוגדר כברירת מחדל
מגדירים את ההיקף הזה כך שכאשר פותחים את הדף Trace Explorer, מוצגים נתוני המעקב של האפליקציה. חשוב לוודא שההיקף הזה כולל את הפרויקטים שבהם מאוחסנים נתוני המעקב של האפליקציה.
בהמשך הקטע מוסבר איך להגדיר את היקפי ההרשאות האלה.
הגדרה של אוסף תצוגות יומן כברירת מחדל
מבצעים אחת מהפעולות הבאות:
אם יש לכם כיור נתונים נצברים ברמת הארגון שמנתב את כל נתוני היומנים בארגון לקטגוריית יומנים מרכזית, מומלץ:
יוצרים תצוגת יומנים בתיקיית היומנים המרכזית של יומני האפליקציה.
בפרויקט המארח או בפרויקט הניהול של App Hub, יוצרים אוסף תצוגות יומן ומוסיפים את תצוגת היומן, ואז מגדירים את האוסף הזה כברירת המחדל.
אם אתם משתמשים בתיקייה לניהול אפליקציות ואין לכם כיור נתונים נצברים ברמת הארגון או תיקיות בתצוגת עץ, מומלץ:
יוצרים כיור מרוכז ליירוט בתיקייה לניהול אפליקציות, ומנתבים את היומנים האלה אל מאגר היומנים
_Defaultשל פרויקט הניהול של התיקייה לניהול אפליקציות.בפרויקט הניהול של התיקייה לניהול אפליקציות, ודאו שאוסף תצוגות היומן שנקרא
_Defaultמוגדר כאוסף תצוגות היומן שמוגדר כברירת מחדל. ההיקף שנקרא_Defaultמציג את התצוגה_AllLogsבקטגוריית היומנים_Defaultשל הפרויקט, שהיא מיקום האחסון המרכזי של האפליקציה.
אם אתם לא משתמשים בכיור נתונים נצבר, אתם צריכים להגדיר את אוסף תצוגות היומן שמוגדר כברירת מחדל בפרויקט המארח או בפרויקט הניהול של App Hub, כדי להציג את מיקומי האחסון של נתוני היומן של האפליקציה. מומלץ להוסיף תצוגות של יומנים לדליים שבהם מאוחסנים נתוני היומנים.
לדוגמה, נניח שהגדרתם תיקייה לניהול אפליקציות ואתם לא משתמשים בכיור נתונים נצברים. לאחר מכן, אפשר לבצע את הפעולות הבאות:
- בפרויקט הניהול של התיקייה לניהול אפליקציות, יוצרים אוסף תצוגות יומן.
מוסיפים לאוסף תצוגות היומן תצוגת יומן אחת לכל פרויקט בתיקייה, כולל פרויקט הניהול.
התצוגה שמוסיפים היא התצוגה
_AllLogsב-_Defaultשל קטגוריית היומנים בפרויקט. התצוגה הזו כוללת את כל היומנים במאגר היומנים_Default, ובמאגר היומנים_Defaultמאוחסנים נתוני יומן האפליקציה.אחרי שתסיימו את השלב הזה, יכול להיות שיופיעו רשומות כאלה באוסף תצוגות היומן:
_Default/_AllLogs my-folder-mp _Default/_AllLogs project-in-my-folder _Default/_AllLogs another-project-in-my-folderאתם שומרים את אוסף תצוגות היומן ומגדירים אותו כברירת המחדל.
הגדרת היקף המדדים בפרויקט
מוודאים שבהיקף המדדים בפרויקט המארח או בפרויקט הניהול ב-App Hub מופיעים כל הפרויקטים שבהם מאוחסנים נתוני המדדים של האפליקציה:
בתיקיות לניהול אפליקציות, Google Cloud Observability מנסה לסנכרן את רשימת הפרויקטים בתיקייה עם רשימת הפרויקטים בהיקף המדדים. לדוגמה, אם מוסיפים פרויקט לתיקייה לניהול אפליקציות, מופעלת פקודה להוספת הפרויקט להיקף המדדים.
אם מספר הפרויקטים בתיקייה לניהול אפליקציות לא חורג מהמכסה של היקף המדדים בפרויקט (ברירת המחדל היא 375 פרויקטים לכל היקף מדדים בפרויקט), Google Cloud Observability יכולה לסנכרן את רשימת הפרויקטים בהיקף המדדים בפרויקט עם רשימת הפרויקטים בתיקייה לניהול אפליקציות. לדוגמה, נניח שהמכסה היא 375 פרויקטים לכל היקף מדדים בפרויקט. אם התיקייה לניהול אפליקציות מכילה 100 פרויקטים, היקף המדדים בפרויקט יכלול את כל הפרויקטים בתיקייה. אם תוסיפו פרויקטים לתיקייה לניהול אפליקציות, הם יתווספו גם להיקף המדדים בפרויקט.
אם מספר הפרויקטים בתיקייה לניהול אפליקציות חורג מהמכסה של היקף המדדים בפרויקט, רשימת הפרויקטים בהיקף המדדים בפרויקט לא תכלול את כל הפרויקטים בתיקייה לניהול אפליקציות. לדוגמה, נניח שהמכסה היא 375 פרויקטים לכל היקף מדדים בפרויקט, ונניח שהתיקייה לניהול אפליקציות מכילה 380 פרויקטים. אחרי שמוסיפים 375 פרויקטים להיקף המדדים, המכסה נגמרת והניסיונות להוסיף את 5 הפרויקטים הנותרים נכשלים. כתוצאה מכך, חלק מנתוני האפליקציה לא זמינים לפרויקט הניהול של התיקייה לניהול אפליקציות.
מומלץ לבדוק את השימוש במכסת היקף המדדים בפרויקט, ולהחליט אם צריך לבקש עדכון של המכסה או לשנות ידנית את היקף המדדים בפרויקט. למידע על השלבים האלה, ראו היקפי המדדים בתיקיות לניהול אפליקציות.
בפרויקטים מארחים של App Hub ובפרויקטים לניהול של גבולות של פרויקט יחיד, צריך להגדיר את היקף המדדים בפרויקט.
אם משנים את קבוצת הפרויקטים שבהם מאוחסנים נתוני המדדים, צריך לעדכן גם את היקף המדדים בפרויקט המארח.
הגדרה של היקף מעקב ברירת המחדל
מבצעים את הפעולות הבאות:
מומלץ להפעיל את Observability API בכל פרויקט שבו יאוחסנו נתוני המעקב של האפליקציה:
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים.בפרויקט המארח או בפרויקט הניהול של App Hub, יוצרים היקף מעקב ומוסיפים פרויקטים שבהם מאוחסנים נתוני המעקב של האפליקציה. אם אתם משתמשים בתיקייה לניהול אפליקציות, הוסיפו את הפרויקטים לתיקייה הזו.
מגדירים את היקף המעקב בהתאמה אישית כהיקף המעקב שמוגדר כברירת מחדל.
בתרשים הטופולוגי אפשר להציג רק נתוני מעקב מפרויקטים שנמצאים באותו ארגון כמו הפרויקט המארח או פרויקט הניהול.
שיוך מדיניות התראות לאפליקציה ב-App Hub
כדי להציג את מדיניות ההתראות בהקשר של מעקב אחרי אפליקציות, צריך לשייך אותה לשירות או לעומס עבודה על ידי הוספת תוויות ספציפיות לאפליקציה למדיניות ההתראות. התוויות האלה שמוגדרות על ידי המשתמשים נכללות גם בכל ההתראות שנוצרות בשביל מדיניות. איך מוסיפים תוויות להתראות לרשימה של תוויות App Hub
כדי לשייך מדיניות התראה לעומס עבודה או לשירות באמצעות מסוף Google Cloud :
-
במסוף Google Cloud , נכנסים לדף notifications Alerting:
אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.
- בסרגל הכלים של מסוףGoogle Cloud , בוחרים את הפרויקט המארח או את פרויקט הניהול של App Hub.
- מוצאים את מדיניות ההתראות, לוחצים על more_vert View more, בוחרים באפשרות Edit ועוברים לקטע Notifications and name.
בקטע Application labels, בוחרים את האפליקציה ואז את השירות או את עומס העבודה:
לוחצים על שמירת המדיניות.
אחרי שתשלימו את השלבים האלה, תוויות עם המפתחות הבאים יצורפו למדיניות ההתראות. התוויות האלה מזהות את האפליקציה ואת השירות או עומס העבודה:
apphub_application_locationapphub_application_idapphub_service_idאוapphub_workload_id
אפשר גם להוסיף תוויות משתמש למדיניות התראה באמצעות Google Cloud CLI, Terraform או Cloud Monitoring API. עם זאת, צריך להשתמש במפתחות התוויות שמוצגים בדוגמה הקודמת. למידע נוסף, קראו את המאמרים הבאים:
הענקת גישה
באמצעות IAM אפשר לנהל את הגישה לנתוני היומנים, המדדים והמעקב. בקטע הזה מופיע סיכום של התפקידים שאפשר להקצות לחשבונות משתמשים:
גישה לתצוגת יומנים (
roles/logging.viewAccessor) בתצוגות היומנים שמופיעות בהיקף ברירת המחדל של היומנים בפרויקט המארח או בפרויקט הניהול של App Hub. למידע נוסף על מתן גישה לתצוגת יומנים, קראו את המאמר שליטה בגישה לתצוגת יומנים.מציג היומנים (
roles/logging.viewer) בפרויקט המארח או בפרויקט הניהול של App Hub, ובכל פרויקט אחר שמופיע באוסף תצוגות היומן (log scope) שמוגדר כברירת מחדל. התפקיד הזה נותן גישה לרוב הרשומות בתיקיית היומנים_Default. מידע נוסף זמין במאמר תפקידי רישום ביומן.התפקיד עריכת מעקב (
roles/monitoring.editor) בפרויקט המארח או בפרויקט הניהול של App Hub. לחשבונות ראשיים שלא צריכים ליצור מדיניות התראות, כדאי להקצות את התפקיד צפייה ב-Monitoring (roles/monitoring.viewer).משתמש ב-Cloud Trace (
roles/cloudtrace.user) בפרויקט המארח או בפרויקט הניהול של App Hub, ובפרויקטים שרשומים בהיקף ברירת המחדל של המעקב.צפייה ב-App Hub (
roles/apphub.viewer) בפרויקט המארח או בפרויקט הניהול של App Hub.