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

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

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

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

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

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

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

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

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

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

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

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

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

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

    omni_enable_telemetry = off

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

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

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

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

    psql -h HOST -U USER -d DATABASE

    מחליפים את הפרטים הבאים:

    • ‫HOST: שם המארח או כתובת ה-IP של מכונת AlloyDB Omni, לדוגמה 127.0.0.1.
    • ‫USER: משתמש מסד הנתונים שאליו רוצים להתחבר, לדוגמה postgres.
    • ‫DATABASE: מסד הנתונים שאליו רוצים להתחבר, לדוגמה postgres.

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

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. טוענים מחדש את ההגדרות או מפעילים מחדש את המכונה. בחלק מההגדרות של קונטיינרים, יכול להיות שתצטרכו להפעיל מחדש את המכונה כדי לוודא שהשינוי נקלט במלואו על ידי ה-background worker.

    SELECT pg_reload_conf();

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

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

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

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

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

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

    omni_enable_telemetry = on

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

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

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

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

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

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

    docker restart CONTAINER_NAME

    מחליפים את הפרטים הבאים:

    • ‫CONTAINER_NAME: השם של מאגר AlloyDB Omni, לדוגמה my-omni-1.

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

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

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

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

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

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

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

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

docker top CONTAINER_NAME

מחליפים את הפרטים הבאים:

  • ‫CONTAINER_NAME: השם של מאגר AlloyDB Omni, לדוגמה my-omni-1.

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

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

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

docker logs CONTAINER_NAME 2>&1 | grep telemetry

מחליפים את הפרטים הבאים:

  • ‫CONTAINER_NAME: השם של מאגר AlloyDB Omni, לדוגמה my-omni-1.

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

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 באופן מקומי או מרחוק.

חיבור מקומי

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

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

  • ‫CONTAINER_NAME: השם של מאגר AlloyDB Omni, לדוגמה my-omni-1.

חיבור מרחוק

/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, כפי שמפורט בקטע הפעלת תוסף.