התאמה אישית של ההתקנה של AlloyDB Omni

בחירת גרסת תיעוד:

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

הפעלה והשבתה של מדידת נתונים מרחוק ב-AlloyDB Omni

מדידת הנתונים מרחוק ב-AlloyDB Omni מטמיעה סוכן לקוח קל שאוסף קבוצה של מדדים בסיסיים עם פסאודונימים ושולח אותם לנקודת קצה (endpoint) שמנוהלת על ידי Google.

מכיוון ש-AlloyDB Omni הוא מוצר שניתן להורדה ומוצע ללא תשלום, נתוני הטלמטריה האלה מספקים ל-Google מדדים חיוניים של מידע שלא מאפשר זיהוי אישי (non-PII) לגבי סביבות הפריסה וההטמעה הגנריות של מכונות פועלות. הנתונים האלה עוזרים לנו לפתח את המוצר ולקבוע את סדר העדיפויות של התמיכה.

המדדים שנאספים כוללים:

  • מזהה התקנה ייחודי (UUID עם פסאודונימיזציה)
  • גרסת AlloyDB Omni והגרסה הראשית של PostgreSQL
  • פרטי מערכת המארח, כמו מספר המעבדים, ה-RAM וזמן הפעולה
  • מידע על הגדרת מסד הנתונים ונתוני שימוש בתכונות, כולל דגלים לניהול מסד נתונים, פרמטרים של Grand Unified Configuration או GUC וסטטיסטיקות מצטברות שקשורות לשימוש בתכונות של AlloyDB Omni וביכולות של מסד הנתונים

השבתה של הדיווח על נתוני הטלמטריה

כדי למנוע מהסוכן הטלמטרי לפעול ולדווח על מדדי שימוש, מגדירים את הפרמטר omni_enable_telemetry של PostgreSQL ל-off. כדי להשבית את סוכן הטלמטריה, אפשר להגדיר את דגל הטלמטריה בקובץ postgresql.conf או להגדיר את הדגל בזמן הריצה באמצעות ALTER SYSTEM.

הגדרת דגל הטלמטריה בקובץ postgresql.conf

כדי לשנות את קובץ התצורה של PostgreSQL, פועלים לפי השלבים הבאים:

  1. מאתרים את הקובץ postgresql.conf בספריית הנתונים של מסד הנתונים. כברירת מחדל, הערך הוא /var/lib/postgresql/MAJOR_VERSION/data.

  2. השבתה של מדידת נתונים מרחוק ב-AlloyDB Omni.

    omni_enable_telemetry = off

  3. כדי להחיל את השינוי, מפעילים מחדש את שירות AlloyDB Omni. סוכן הטלמטריה מפסיק לאסוף ולשלוח ל-Google מדדי שימוש.

    systemctl restart alloydbomniMAJOR_VERSION

הגדרת דגל הטלמטריה בזמן הריצה באמצעות ALTER SYSTEM

כדי להגדיר את דגל הטלמטריה ולשמור את השינוי גם אחרי הפעלה מחדש, פועלים לפי השלבים הבאים:

  1. מתחברים למופע AlloyDB Omni באמצעות psql:

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

  2. מריצים את הפקודה הבאה:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

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

    systemctl restart alloydbomni18

    סוכן הטלמטרייה מפסיק לאסוף ולשלוח מדדי שימוש אל Google.

הפעלת דיווח על נתוני טלמטריה

אם השבתתם בעבר את מדידת הנתונים מרחוק ב-AlloyDB Omni, אתם יכולים להפעיל אותה מחדש על ידי הגדרת הדגל omni_enable_telemetry ל-on. כדי להפעיל את סוכן הטלמטריה, מגדירים את הדגל בקובץ postgresql.conf או מגדירים את הדגל בזמן הריצה באמצעות ALTER SYSTEM.

הגדרת דגל הטלמטריה בקובץ postgresql.conf

  1. מאתרים את הקובץ postgresql.conf בספריית הנתונים של מסד הנתונים.

  2. מגדירים את השורה הבאה:

    omni_enable_telemetry = on

  3. כדי שהשינוי ייכנס לתוקף, צריך להפעיל מחדש את שירות AlloyDB Omni.

    systemctl restart alloydbomni18

הגדרת דגל הטלמטריה בזמן הריצה באמצעות ALTER SYSTEM

  1. מתחברים למכונה של AlloyDB Omni באמצעות psql.

  2. מריצים את הפקודה הבאה:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. כדי להחיל את השינוי, מפעילים מחדש את שירות AlloyDB Omni.

    systemctl restart alloydbomni18

בדיקת הסטטוס של מדידת נתונים מרחוק ב-AlloyDB Omni

אתם יכולים לבדוק את הסטטוס של סוכן מדידת הנתונים מרחוק ב-AlloyDB Omni, כולל אם הוא מופעל או מושבת. אפשר גם לבדוק את הפעילות של סוכן הטלמטריה.

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

כדי לבדוק את הסטטוס של הגדרת הטלמטריה, פועלים לפי השלבים הבאים:

  1. מתחברים למכונה.
  2. מריצים את הפקודה הבאה:
SHOW omni_enable_telemetry;

הפלט מחזיר את הערך on או off, בהתאם להשבתה או להפעלה של מדידת הנתונים מרחוק ב-AlloyDB Omni.

איך בודקים אם סוכן הטלמטריה פועל

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

ps -ef | grep "omni telemetry worker"

אם הטלמטריה מופעלת ופועלת, הפלט מכיל שורה עם הטקסט postgres: omni telemetry worker.

בדיקת הפעילות של סוכן הטלמטריה

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

journalctl -u alloydbomni18 | grep telemetry

אם סוכן הטלמטריה פועל, היומנים מכילים הודעות שדומות לאלה:

LOG:  [telemetry_agent_worker.cc:143]  Started telemetry worker
LOG:  [telemetry_agent_worker.cc:161]  Running telemetry reporting agent
telemetry_agent: Uploading telemetry data to https://cloud.google.com/log.

התחברות למכונה

בהתאם לסביבה שלכם, אתם יכולים להתחבר למכונה של AlloyDB Omni באופן מקומי או מרחוק.

חיבור מקומי

כדי להתחבר למכונה של AlloyDB Omni באופן מקומי, מריצים את הפקודה הבאה:

/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost

חיבור מרחוק

/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN

מחליפים את המשתנים הבאים:

  • ‫HOST_PORT: יציאת ה-TCP שבה השתמשתם במהלך ההתקנה.
  • ‫IP_ADDRESS_OR_FQDN: כתובת ה-IP או שם הדומיין המלא של המארח שבו פועל AlloyDB Omni.

הפעלת תוספים

רשימת התוספים שזמינים ב-AlloyDB Omni מופיעה במאמר תוספי מסד נתונים נתמכים. ‫PostGIS ו-Orafce לא כלולים ב-AlloyDB Omni, אבל אפשר להתקין אותם לפי ההוראות הבאות:

התוספים המותקנים מופעלים באמצעות הצהרות CREATE EXTENSION סטנדרטיות של PostgreSQL, כפי שמפורט בקטע הפעלת תוסף.