שימוש בעורך הקוד ל-PromQL

בדף הזה מוסבר איך להשתמש בעורך הקוד ל-PromQL. העורך זמין במסוף ומספק הצעות וכלים אחרים ליצירת שאילתות PromQL תקינות. Google Cloud

בדף הזה לא מוסבר על השפה PromQL. כדי לקבל מידע על PromQL, מומלץ לעיין במאמרי העזרה של קוד פתוח. מקורות המידע הבאים יעזרו לכם להתחיל:

• שאילתות ב-Prometheus
• דוגמאות לשאילתות
• תקציר של PromQL

גישה לעורך הקוד

אפשר לגשת ל-PromQL מהדפים הבאים במסוף Google Cloud :

• Metrics Explorer
• הוספת ווידג'ט כשיוצרים לוחות בקרה

כדי לפתוח את עורך הקוד כשמשתמשים ב-Metrics Explorer:

1. במסוף Google Cloud , עוברים לדף leaderboard Metrics explorer:

   כניסה אל Metrics Explorer

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

2. בסרגל הכלים של חלונית הכלי ליצירת שאילתות, לוחצים על הלחצן ששמו הוא code MQL או code PromQL.
3. מוודאים שהאפשרות PromQL נבחרה במתג שפה. המתג לשפה נמצא באותו סרגל כלים שבו אפשר לעצב את השאילתה.

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

   • הגדרת אפשרויות התצוגה של התרשים
   • הגדרת מקראים

שימוש בעורך הקוד

כדי להשתמש בעורך הקוד, מקלידים את השאילתה בשדה הטקסט ולוחצים על Run Query.

השלמה אוטומטית

בזמן ההקלדה של השאילתה, העורך מציג רשימה של השלמות שתקפות מבחינת התחביר. אפשר להציג את תפריט ההשלמה האוטומטית באופן ידני על ידי לחיצה על Control+Space, ואפשר לסגור אותו על ידי לחיצה על Escape.

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

כדי להוסיף את הקידומת שמשותפת לכל האפשרויות הזמינות, לוחצים על Tab.

חיפוש והחלפה

הכלי Editor תומך בתכונה 'חיפוש והחלפה'. כדי למצוא מונחים בשאילתה ולהחליף אותם (אם רוצים), לוחצים על Control+F (או על Command+F ב-Mac). בצילום המסך הבא אפשר לראות את התכונה:

אמצעי בקרה לעורכים

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

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

כדי להפעיל את האפשרות להפעלה אוטומטית, משתמשים במתג הפעלה אוטומטית. כשהאפשרות הזו מופעלת, העורך פועל באופן הבא:

• הלחצן הפעלת שאילתה לא מוצג.
• הודעות השגיאה מופיעות ברציפות בזמן ההקלדה.

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

  העורך לא מנסה להעריך שאילתות לא שלמות.

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

שמירת תרשימים

האופן שבו שומרים תרשים תלוי בהקשר שבו יצרתם אותו:

• מ-Metrics Explorer.
• במסגרת יצירה או עריכה של מרכז בקרה בהתאמה אישית.

שמירת תרשימים מ-Metrics Explorer

בעורך הקוד ב-Metrics Explorer, יש אפשרות לשמור את התרשים בלוח בקרה בהתאמה אישית. כדי לשמור את התרשים:

1. במסוף Google Cloud , עוברים לדף leaderboard Metrics explorer:

   כניסה אל Metrics Explorer

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

2. בסרגל הכלים של חלונית הכלי ליצירת שאילתות, לוחצים על הלחצן ששמו הוא code MQL או code PromQL.
3. מוודאים שהאפשרות PromQL נבחרה במתג שפה. המתג לשפה נמצא באותו סרגל כלים שבו אפשר לעצב את השאילתה.
4. מזינים את השאילתה בעורך.

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

6. לוחצים על שמירת התרשים.

7. כדי להמשיך לשמור את התרשים:

   1. נותנים לתרשים שם תיאורי.
   2. בוחרים את מרכז הבקרה של התרשים החדש.
   3. לוחצים על שמירה בתיבת הדו-שיח.

שמירת תרשימים במרכז בקרה בהתאמה אישית

כדי לשמור תרשים חדש במרכז הבקרה:

1. נותנים לתרשים שם תיאורי.

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

3. אם לא הפעלתם שמירה אוטומטית של לוח הבקרה, צריך ללחוץ על שמירה.

במסוף Google Cloud אפשר להשתמש במסננים ברמת הדף בלוחות בקרה מותאמים אישית. המסננים האלה נתמכים בתרשימי PromQL בלוחות הבקרה המותאמים אישית.

יציאה מעורך הקוד

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