PostgreSQL

השילוב של PostgreSQL אוסף מדדים של השימוש במסד הנתונים, כמו גודל מסד הנתונים, מספר ה-backends או מספר הפעולות. השילוב גם אוסף יומנים של PostgreSQL ומנתח אותם למטען ייעודי (payload) בפורמט JSON. התוצאה הזו כוללת שדות לתפקיד, למשתמש, לרמה ולהודעה.

מידע נוסף על PostgreSQL זמין במאמרי העזרה של PostgreSQL.

דרישות מוקדמות

כדי לאסוף נתוני טלמטריה של PostgreSQL, צריך להתקין את Ops Agent:

• כדי להשתמש במדדים, צריך להתקין את גרסה 2.21.0 ואילך.
• כדי לראות את היומנים, צריך להתקין את גרסה 2.9.0 ומעלה.

השילוב הזה תומך ב-PostgreSQL בגרסה 10.18 ומעלה.

הגדרת מכונת PostgreSQL

מקלט postgresql מתחבר כברירת מחדל לשרת postgresql מקומי באמצעות שקע Unix ואימות Unix בתור משתמש root.

הגדרת סוכן התפעול ל-PostgreSQL

פועלים לפי המדריך בנושא הגדרת Ops Agent, מוסיפים את הרכיבים הנדרשים לאיסוף טלמטריה ממופעי PostgreSQL ומפעילים מחדש את הסוכן.

הגדרה לדוגמה

הפקודות הבאות יוצרות את ההגדרה לאיסוף ולעיבוד של נתוני טלמטריה עבור PostgreSQL:‏

# Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    postgresql:
      type: postgresql
      username: postgres
      password: abc123
      # To use the googlesecretmanager provider to replace plaintext passwords, refer to the example below.
      # password: ${googlesecretmanager:projects/<project-id>/secrets/<secret-id>/versions/<version-id>}
      insecure: true
      endpoint: localhost:5432
  service:
    pipelines:
      postgresql:
        receivers:
        - postgresql
logging:
  receivers:
    postgresql_general:
      type: postgresql_general
  service:
    pipelines:
      postgresql:
        receivers:
          - postgresql_general
EOF

כדי שהשינויים האלה ייכנסו לתוקף, צריך להפעיל מחדש את Ops Agent:

Linux

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

   sudo systemctl restart google-cloud-ops-agent
   

2. כדי לוודא שהסוכן הופעל מחדש, מריצים את הפקודה הבאה ומוודאים שהרכיבים Metrics Agent ו-Logging Agent הופעלו:

   sudo systemctl status "google-cloud-ops-agent*"
   

Windows

1. מתחברים למופע באמצעות RDP או כלי דומה ומתחברים ל-Windows.
2. פותחים טרמינל ב-PowerShell עם הרשאות אדמין על ידי לחיצה ימנית על סמל PowerShell ובחירה באפשרות הפעלה כמנהל מערכת.
3. כדי להפעיל מחדש את הסוכן, מריצים את פקודת PowerShell הבאה:

   Restart-Service google-cloud-ops-agent -Force
   

4. כדי לוודא שהסוכן הופעל מחדש, מריצים את הפקודה הבאה ומוודאים שהרכיבים Metrics Agent ו-Logging Agent הופעלו:

   Get-Service google-cloud-ops-agent*
   

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

כדי להטמיע יומנים מ-PostgreSQL, צריך ליצור מקלט ליומנים ש-PostgreSQL מייצר, ואז ליצור צינור למקלט החדש.

כדי להגדיר מקלט ליומני postgresql_general, מציינים את השדות הבאים:

שדה	ברירת מחדל	תיאור
exclude_paths		רשימה של תבניות נתיבים במערכת הקבצים שצריך להחריג מהקבוצה שתואמת ל-include_paths.
include_paths	[/var/log/postgresql/postgresql*.log, /var/lib/pgsql/data/log/postgresql*.log, /var/lib/pgsql/*/data/log/postgresql*.log]	רשימה של נתיבי מערכת קבצים לקריאה על ידי מעקב אחרי כל קובץ. אפשר להשתמש בתו כללי לחיפוש (*) בנתיבים.
record_log_file_path	false	אם הערך הוא true, הנתיב לקובץ הספציפי שממנו נלקחה רשומת היומן מופיע ברשומת היומן של הפלט כערך של התווית agent.googleapis.com/log_file_path. כשמשתמשים בתו כללי, רק הנתיב של הקובץ שממנו התקבל הרשומה מתועד.
type		הערך חייב להיות postgresql_general.
wildcard_refresh_interval	60s	המרווח שבו נתיבי קבצים עם תו כללי ב-include_paths מתעדכנים. הערך מוצג כמשך זמן, לדוגמה 30s או 2m. הנכס הזה יכול להיות שימושי כשקצב העברת הנתונים של הרישום גבוה, וקובצי היומן מתחלפים מהר יותר מהמרווח שמוגדר כברירת מחדל.

מה נרשם ביומן

הערך של logName נגזר ממזהי המקלט שצוינו בהגדרה. אלה השדות המפורטים שבתוך LogEntry:

יומני postgresql_general מכילים את השדות הבאים ב-LogEntry:

שדה	סוג	תיאור
jsonPayload.database	מחרוזת	שם מסד הנתונים של הפעולה שנרשמת ביומן, אם רלוונטי
jsonPayload.level	מחרוזת	חומרת היומן או סוג האינטראקציה עם מסד הנתונים עבור חלק מהיומנים
jsonPayload.message	מחרוזת	יומן של פעולת מסד הנתונים
jsonPayload.tid	מספר	מזהה השרשור שממנו נוצר היומן
jsonPayload.user	מחרוזת	משתמש מאומת לפעולה שנרשמת ביומן, כשזה רלוונטי
severity	מחרוזת (LogSeverity)	רמת רשומת היומן (מתורגמת).

הגדרת איסוף מדדים

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

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

כדי להגדיר נמען למדדים של postgresql, צריך לציין את השדות הבאים:

שדה	ברירת מחדל	תיאור
ca_file		הנתיב לאישור CA. בתור לקוח, הוא מאמת את אישור השרת. אם העמודה ריקה, המקבל משתמש ב-CA הבסיסי של המערכת.
cert_file		נתיב לאישור TLS לשימוש בחיבורים שנדרש בהם mTLS.
collection_interval	60s	ערך של משך זמן, כמו 30s או 5m.
endpoint	/var/run/postgresql/.s.PGSQL.5432	הנתיב של hostname:port או של שקע Unix שמתחיל ב-/ ומשמש לחיבור לשרת PostgreSQL.
insecure	true	הגדרה שקובעת אם להשתמש בחיבור TLS מאובטח. אם המדיניות מוגדרת לערך false, פרוטוקול TLS מופעל.
insecure_skip_verify	false	ההגדרה קובעת אם לדלג על אימות האישור או לא. אם הערך של insecure הוא true, המערכת לא משתמשת בערך insecure_skip_verify.
key_file		הנתיב למפתח ה-TLS שבו יש להשתמש לחיבורים שנדרש בהם mTLS.
password		הסיסמה שמשמשת לחיבור לשרת.
type		הערך חייב להיות postgresql.
username		שם המשתמש שמשמש לחיבור לשרת.

מה נבדק

בטבלה הבאה מפורטים המדדים שנאספים על ידי סוכן תפעול ממופע PostgreSQL.

סוג המדד
סוג, סוג משאבים במעקב	תוויות
workload.googleapis.com/postgresql.backends
GAUGE, INT64 gce_instance	database
workload.googleapis.com/postgresql.bgwriter.buffers.allocated
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/postgresql.bgwriter.buffers.writes
CUMULATIVE, INT64 gce_instance	source
workload.googleapis.com/postgresql.bgwriter.checkpoint.count
CUMULATIVE, INT64 gce_instance	type
workload.googleapis.com/postgresql.bgwriter.duration
CUMULATIVE, INT64 gce_instance	type
workload.googleapis.com/postgresql.bgwriter.maxwritten
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/postgresql.blocks_read
CUMULATIVE, INT64 gce_instance	database source table
workload.googleapis.com/postgresql.commits
CUMULATIVE, INT64 gce_instance	database
workload.googleapis.com/postgresql.connection.max
GAUGE, INT64 gce_instance
workload.googleapis.com/postgresql.database.count
GAUGE, INT64 gce_instance
workload.googleapis.com/postgresql.db_size
GAUGE, INT64 gce_instance	database
workload.googleapis.com/postgresql.index.scans
CUMULATIVE, INT64 gce_instance	database index table
workload.googleapis.com/postgresql.index.size
GAUGE, INT64 gce_instance	database index table
workload.googleapis.com/postgresql.operations
CUMULATIVE, INT64 gce_instance	database operation table
workload.googleapis.com/postgresql.replication.data_delay
GAUGE, INT64 gce_instance	replication_client
workload.googleapis.com/postgresql.rollbacks
CUMULATIVE, INT64 gce_instance	database
workload.googleapis.com/postgresql.rows
GAUGE, INT64 gce_instance	database state table
workload.googleapis.com/postgresql.table.count
GAUGE, INT64 gce_instance	database
workload.googleapis.com/postgresql.table.size
GAUGE, INT64 gce_instance	database table
workload.googleapis.com/postgresql.table.vacuum.count
CUMULATIVE, INT64 gce_instance	database table
workload.googleapis.com/postgresql.wal.age
GAUGE, INT64 gce_instance
workload.googleapis.com/postgresql.wal.lag
GAUGE, INT64 gce_instance	operation replication_client

אימות ההגדרה

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

כדי לוודא שיומני PostgreSQL נשלחים אל Cloud Logging:

1. במסוף Google Cloud , נכנסים לדף segment Logs Explorer:

   כניסה אל Logs Explorer

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

2. מזינים את השאילתה הבאה בעורך ולוחצים על Run query:
   

   resource.type="gce_instance"
   log_id("postgresql_general")
   

כדי לוודא שמדדי PostgreSQL נשלחים אל Cloud Monitoring, מבצעים את הפעולות הבאות:

1. נכנסים לדף  Metrics explorer במסוף Google Cloud :

   כניסה אל Metrics Explorer

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

2. בסרגל הכלים של החלונית ליצירת שאילתות, לוחצים על הלחצן ששמו  PromQL.
3. מזינים את השאילתה הבאה בעורך ולוחצים על Run query:
   

   {"workload.googleapis.com/postgresql.backends", monitored_resource="gce_instance"}
   

צפייה בלוח הבקרה

כדי לראות את המדדים של PostgreSQL, צריך להגדיר תרשים או לוח בקרה. השילוב של PostgreSQL כולל לוח בקרה אחד או יותר. כל מרכזי הבקרה מותקנים אוטומטית אחרי שמגדירים את השילוב וסוכן Ops מתחיל לאסוף נתונים של מדדים.

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

כדי לראות מרכז בקרה שהותקן:

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

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

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

2. לוחצים על הכרטיסייה רשימת לוחות הבקרה ואז בוחרים בקטגוריה שילובים.
3. לוחצים על השם של מרכז הבקרה שרוצים להציג.

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

כדי לראות תצוגה מקדימה סטטית של מרכז הבקרה:

1. נכנסים לדף  Integrations במסוף Google Cloud :

   עוברים אל שילובים

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

2. לוחצים על המסנן Compute Engine של פלטפורמת הפריסה.
3. מאתרים את הערך של PostgreSQL ולוחצים על הצגת פרטים.
4. לוחצים על הכרטיסייה מרכזי בקרה כדי לראות תצוגה מקדימה סטטית. אם מרכז הבקרה מותקן, אפשר לעבור אליו בלחיצה על View dashboard (הצגת מרכז הבקרה).

מידע נוסף על לוחות בקרה ב-Cloud Monitoring זמין במאמר בנושא לוחות בקרה וטבלאות.

מידע נוסף על השימוש בדף Integrations (שילובים) זמין במאמר ניהול שילובים.

התקנה של כללי מדיניות התראות

מדיניות התראות מורה ל-Cloud Monitoring לשלוח לכם התראה כשמתרחשים תנאים מסוימים. השילוב של PostgreSQL כולל מדיניות התראות אחת או יותר שתוכלו להשתמש בהן. אפשר לראות ולהתקין את מדיניות ההתראות הזו בדף שילובים ב-Monitoring.

כדי לראות את התיאורים של כללי מדיניות ההתראות הזמינים ולהתקין אותם:

1. נכנסים לדף  Integrations במסוף Google Cloud :

   עוברים אל שילובים

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

2. מחפשים את הערך של PostgreSQL ולוחצים על הצגת פרטים.
3. לוחצים על הכרטיסייה התראות. בכרטיסייה הזו מופיעים תיאורים של מדיניות ההתראות הזמינה וממשק להתקנתן.
4. התקנה של כללי מדיניות התראות. כדי שמדיניות ההתראות תדע לאן לשלוח התראות על הפעלה של התראה, היא צריכה לקבל מכם מידע להתקנה. כדי להתקין מדיניות התראות:
   1. ברשימת מדיניות ההתראות הזמינה, בוחרים את אלה שרוצים להתקין.

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

      מידע נוסף על ערוצי התראות זמין במאמר בנושא ניהול ערוצי התראות.

   3. לוחצים על יצירת מדיניות.

למידע נוסף על מדיניות התראות ב-Cloud Monitoring, אפשר לעיין במאמר מבוא להתראות.

מידע נוסף על השימוש בדף Integrations (שילובים) זמין במאמר ניהול שילובים.

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

בסרטון Install the Ops Agent to troubleshoot third-party applications מוסבר איך להשתמש ב-Ansible כדי להתקין את סוכן תפעול, להגדיר אפליקציית צד שלישי ולהתקין לוח בקרה לדוגמה.