הגדרת הסוכן לעומסי עבודה של Oracle

במאמר הזה נסביר איך להתקין את Agent for Compute Workloads, להגדיר אותו ולאמת אותו במכונות של Compute Engine שמריצות עומסי עבודה של Oracle Database.

הסוכן אוסף מדדים שונים של Oracle על ידי שליחת שאילתות לתצוגות הביצועים של Oracle Database (כמו V$DATABASE, ‏ V$INSTANCE ו-V$DATAGUARD_STATS) ולתצוגות של מילון הנתונים (כמו DBA_DATA_FILES ו-DBA_FREE_SPACE). לאחר מכן המדדים האלה נשלחים ל-Cloud Monitoring, שם אפשר להציג אותם ולנתח אותם. רשימת המדדים הנתמכים

לפני שמתחילים

לפני שמתקינים את Agent for Compute Workloads כדי לעקוב אחרי עומסי העבודה של Oracle Database, צריך לוודא שמתקיימות הדרישות המוקדמות הבאות:

בדיקת דרישות המערכת

בטבלה הבאה מפורטות מהדורות Oracle שבהן אפשר להשתמש וגרסאות מערכות ההפעלה הנתמכות:

מערכות הפעלה גרסאות Oracle מהדורות Oracle
  • גרסאות 7, 8 ו-9 של Red Hat Enterprise Linux
  • ‫Oracle Linux בגרסאות 7, 8 ו-9
  • Oracle Database 19c
  • ‫Oracle Database 23ai*
  • מהדורת Enterprise
  • מהדורה סטנדרטית
  • מהדורת Express (בחינם)

הקצאת תפקידי IAM לחשבון השירות

ה-Agent for Compute Workloads משתמש בחשבון השירות שמצורף למופע המחשוב לצורך אימות ולגישה למשאבי Google Cloud .

כדי לשפר את האבטחה, מומלץ להשתמש בחשבון שירות למטרה אחת במקום להשתמש בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine.

כדי לוודא שלחשבון השירות יש את ההרשאות הנדרשות כדי לאפשר לסוכן של Compute Workloads לבצע אימות מול משאבים שלGoogle Cloud ולגשת אליהם Google Cloud , צריך לבקש מהאדמין להקצות לחשבון השירות את תפקידי ה-IAM הבאים בפרויקט:

  • איסוף מדדים ממכונת החישוב: Compute Viewer (roles/compute.viewer)
  • כתיבת נתונים למחסן הנתונים של Workload Manager: Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
  • שליחת יומני סוכנים אל Cloud Logging: Logs Writer (roles/logging.logWriter)
  • אם אתם משתמשים ב-Secret Manager כדי לאחסן את הסיסמה להתחברות למופע Oracle: Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)

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

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

הפעלת גישה לממשקי Cloud API

‫Compute Engine ממליץ להגדיר את המכונות כך שיאפשרו את כל היקפי הגישה לכל ממשקי Cloud API, ולהשתמש רק בהרשאות IAM של חשבון השירות של המכונה כדי לשלוט בגישה למשאביGoogle Cloud . מידע נוסף זמין במאמר יצירת מכונה וירטואלית שמשתמשת בחשבון שירות שמנוהל על ידי משתמש.

אם מגבילים את הגישה ל-Cloud APIs, ל-Agent for Compute Workloads נדרשות לפחות הרשאות הגישה הבאות ל-Cloud APIs במכונת המחשוב המארחת:

https://www.googleapis.com/auth/cloud-platform

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

אם אתם מריצים עומס עבודה של Oracle על מופע חישוב שאין לו כתובת IP חיצונית, אתם צריכים להפעיל גישה פרטית ל-Google ברשת המשנה של המופע כדי שה-Agent for Compute Workloads יוכל לגשת ל-Google APIs ולשירותים של Google. מידע על הפעלת גישה פרטית ל-Google זמין במאמר הגדרת גישה פרטית ל-Google.

התקנה והגדרה של הסוכן באמצעות מנהל החבילות

בקטע הזה מוסבר איך להתקין את Agent for Compute Workloads במכונת החישוב ולהגדיר אותו להתחבר למכונת Oracle באמצעות מנהל חבילות.

כדי להתקין את Agent for Compute Workloads, מבצעים את השלבים הבאים:

  1. יוצרים קובץ תצורה של מאגר.

    sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Workload Agent
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

  2. מעדכנים את המטא-נתונים של מנהל החבילות:

    sudo yum makecache

  3. התקנת חבילת google-cloud-workload-agent rpm:

    sudo yum install google-cloud-workload-agent

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

התקנה וניהול של הסוכן בצי של מכונות וירטואליות באמצעות VM Extension Manager

הגדרת VM Extension Manager

כדי להגדיר את VM Extension Manager, מבצעים את השלבים הבאים:

התקנת הסוכן בצי של מכונות וירטואליות

כדי להתקין את הגרסה העדכנית של Agent for Compute Workloads בצי מכונות ה-VM באזור ספציפי באמצעות מדיניות של VM Extension Manager, צריך לבצע את השלבים הבאים:

המסוף

  1. נכנסים לדף VM extension policies במסוף Google Cloud .

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

  2. לוחצים על יצירת מדיניות לגבי תוספים.

  3. בשדה Name, מזינים שם למדיניות.

  4. אופציונלי: בשדה תיאור, מזינים תיאור למדיניות.

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

  6. ברשימות Region ו-Zone, בוחרים את התחום שבו רוצים להחיל את המדיניות הזו.

  7. בקטע תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:

    1. ברשימה Extension (תוסף), בוחרים באפשרות Google Cloud's Extension for Compute Workloads (התוסף של Google Cloud לעומסי עבודה של מחשוב).

    2. משאירים את השדה Version (גרסה) ריק.

      ההגדרה הזו מכוונת את המדיניות להתקין את הגרסה האחרונה של Agent for Compute Workloads.

    3. בשדה Configuration file content (תוכן קובץ התצורה), מזינים את ההגדרות שרוצים להחיל על הסוכן.

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

    4. לוחצים על סיום.

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

    1. לוחצים על הוספת תוויות וכוללים את התוויות שמזהות את מכונות ה-VM הנדרשות.
    2. לוחצים על סיום.

  9. לוחצים על יצירה.

gcloud 

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

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

  • ‫POLICY_NAME: שם למדיניות של תוסף ה-VM.

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

  • ‫ZONE: האזור שבו רוצים להחיל את המדיניות הזו.

  • ‫CONFIG_FILE_PATH: הנתיב המקומי לקובץ ה-JSON שמכיל את ההגדרה של Agent for Compute Workloads לחיבור עם עומס העבודה של Oracle.

    • לחלופין, כדי לספק את התצורה כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file. לדוגמה: --config=google-cloud-workload-extension="CONFIG". לפי ההמלצה שלGoogle Cloud , כדאי להשתמש ב---config-from-file.
    • אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
    • מידע על פרמטרי ההגדרה שנתמכים על ידי הסוכן עבור עומס העבודה של Oracle זמין במאמר פרמטרי הגדרה.

  • ‫DESCRIPTION: תיאור אופציונלי של המדיניות.

  • ‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים את התוויות שבהן המדיניות ממקדת מכונות וירטואליות.

    • כדי שמדיניות תכוון למכונה וירטואלית, המכונה הווירטואלית צריכה לכלול את כל התוויות שצוינו.
    • אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהסלקטורים שצוינו (לוגיקת OR). אם משמיטים את הדגל הזה, המדיניות מטרגטת את כל המכונות הווירטואליות באזור שצוין.

  • ‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000.

לדוגמה:

הפקודה הבאה יוצרת מדיניות בשם test-agent-policy בפרויקטGoogle Cloud בשם test-project, שמתקינה את הגרסה האחרונה של Agent for Compute Workloads בכל המכונות הווירטואליות שנפרסו באזור us-centrail-f. ההגדרה שצוינה ב-agent-config.json מוחלת על הסוכן.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

אימות ההתקנה של הנציג

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

  1. יוצרים חיבור SSH למכונת Compute.

  2. בודקים את הסטטוס של חבילת הסוכן:

    systemctl status google-cloud-workload-agent

    אם חבילת הסוכן פועלת כמצופה, הפלט יכיל את הערך active (running). לדוגמה:

    google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

    פרמטרים להגדרה

    ‫Agent for Compute Workloads תומך בפרמטרים הבאים של הגדרות ל-Oracle:

    פרמטר תיאור
    log_level

    String

    כדי להגדיר את רמת הרישום ביומן של הסוכן, מוסיפים את רמות היומן. אלה רמות היומן הזמינות:
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    ברירת המחדל היא INFO.
    log_to_cloud

    Boolean

    כדי להפנות את היומנים של הסוכן אל Cloud Logging, צריך לציין true. ערך ברירת המחדל הוא true.
    oracle_configuration.enabled

    Boolean

    זה שינוי אופציונלי. קובעת אם שירות Oracle פעיל. אם המדיניות מוגדרת לערך true, או אם היא לא מוגדרת ועומס העבודה קיים, אפשר להגדיר את האפשרות 'גילוי' ואת איסוף המדדים. אם המדיניות מוגדרת לערך false, שירות Oracle והפונקציות שקשורות אליו מושבתים.
    הפרמטרים הבאים שקשורים לילדים רלוונטיים רק כשמציינים את oracle_configuration.enabled: true.
    oracle_configuration.oracle_discovery.enabled

    Boolean

    זה שינוי אופציונלי. קובע אם התכונה Oracle Discovery פעילה.

    ערך ברירת המחדל הוא true.
    oracle_configuration.oracle_discovery.update_frequency

    Int

    זה שינוי אופציונלי. מציינים את מרווח הדגימה בשניות, שקובע את התדירות שבה Agent for Compute Workloads מריץ את תהליך הגילוי. ערך ברירת המחדל הוא 3,600 שניות (שעה אחת).

    חשוב לוודא שהערך מסתיים באות s קטנה כדי לציין שניות. לדוגמה: 30s.
    oracle_configuration.oracle_metrics.enabled

    Boolean

    זה שינוי אופציונלי. כדי להפעיל את Agent for Compute Workloads לאיסוף מדדי המעקב של Oracle, צריך לציין true. ערך ברירת המחדל הוא false.

    הפרמטרים הבאים שקשורים לילדים רלוונטיים רק כשמציינים את הערך oracle_metrics.enabled: true.
    oracle_configuration.oracle_metrics.collection_frequency

    Int

    זה שינוי אופציונלי. מציינים את מרווח הדגימה בשניות, שקובע את התדירות שבה Agent for Compute Workloads שולח שאילתות למופעי Oracle Database כדי לאסוף את מדדי המעקב של Oracle. ערך ברירת המחדל הוא 60 שניות.

    חשוב לוודא שהערך מסתיים באות s קטנה כדי לציין שניות. לדוגמה: 30s.
    oracle_configuration.oracle_metrics.query_timeout

    String

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

    חשוב לוודא שהערך מסתיים באות s קטנה כדי לציין שניות. לדוגמה: 30s.
    oracle_configuration.oracle_metrics.connection_parameters.username

    String

    מציינת את חשבון המשתמש שמשמש לשליחת שאילתות למופע של Oracle Database.

    מוודאים שלמשתמש הזה יש את ההרשאות הנדרשות לקריאת תצוגות הביצועים במסד הנתונים של Oracle.
    oracle_configuration.oracle_metrics.connection_parameters.host

    String

    מציין את המזהה של המכונה המקומית שמארחת את מופע מסד הנתונים.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    מציין את היציאה שבה מופע Oracle Database מקבל שאילתות.
    oracle_configuration.oracle_metrics.connection_parameters.service_name

    String

    מציינים את שם השירות של מופע Oracle Database שרוצים שהסוכן יעקוב אחריו.
    oracle_configuration.oracle_metrics.connection_parameters.secret.project_id

    String

    מציינת את מזהה הפרויקט של Secret Manager כדי לאחזר את הסיסמה של המשתמש שמריץ שאילתות במסד הנתונים.
    oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name

    String

    מציינת את השם של הסוד ב-Secret Manager שבו מאוחסנת הסיסמה של חשבון המשתמש.

    איסוף והצגה של מדדים של Oracle

    אתם יכולים להפעיל איסוף מדדים עבור עומסי עבודה של Oracle Database. רשימת המדדים הנתמכים

    הפעלת איסוף מדדים

    כדי להפעיל את איסוף המדדים של Oracle באמצעות Agent for Compute Workloads, צריך לבצע את הפעולות הבאות:

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

    2. כמשתמש Oracle OS, מריצים את הכלי oraenv כדי להגדיר את משתני הסביבה. אנחנו מניחים שכבר הגדרתם את המשתמש oracle ואת ORACLE_SID בקובץ /etc/oratab.

      sudo su - oracle
export PATH=$PATH:/usr/local/bin
. oraenv
sqlplus / as sysdba

    3. כמשתמש SYSDBA או SYSOPER, יוצרים ב-Oracle Database משתמש למטרות מעקב עם סיסמה שתואמת לסוד שיצרתם בקטע דרישות מוקדמות.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. כמשתמש SYSDBA או SYSOPER, צריך להעניק למשתמש המעקב את ההרשאות הבאות כדי לשלוח שאילתות לתצוגות הביצועים:

      • SESSION
      • SELECT_CATALOG_ROLE
      • SYSDG
      GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;

    5. יוצאים מ-sqlplus ומהמשתמש oracle.

    6. כמשתמש root, עורכים את קובץ ההגדרות של הסוכן באמצעות העורך המועדף.

      sudo nano /etc/google-cloud-workload-agent/configuration.json

    7. בקובץ התצורה, עורכים את הקטע oracle_metrics כדי לבצע את העדכונים הבאים:

      1. מגדירים את הפרמטר enabled לערך true.
      2. מגדירים את הפרמטר service_name כדי לציין את שם השירות של מופע Oracle שהסוכן אמור לנטר.
      3. מציינים את שם המשתמש ב-Oracle שאיתו הסוכן יתחבר למסד הנתונים.
      4. מגדירים את הפרמטרים host ו-port כדי שהסוכן יוכל להתחבר למסד הנתונים.
      5. מגדירים את הפרמטר secret לסוכן כדי לאחזר סיסמה עבור שם המשתמש:
        • ‫project_id: מזהה הפרויקט שמכיל את הנתונים של Secret Manager.
        • ‫secret_name: השם של הסוד ב-Secret Manager.

      קובץ תצורה לדוגמה:

      {
  "log_level": "INFO",
  "common_discovery": {"collection_frequency": "3600s" },
  "oracle_configuration": {
    "enabled": true,
    "oracle_metrics": {
      "enabled": true,
      "collection_frequency": "30s",
      "connection_parameters": [
        {
          "host": "localhost",
          "port": 1521,
          "service_name": "orcl",
          "username": "wlmagent",
          "secret": {
            "project_id": "my-project",
            "secret_name": "wlmagent_password"
          }
        }
      ]
    }
  }
}

    8. שומרים את קובץ ההגדרות.

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

    הצגת המדדים

    אפשר לראות את המדדים שנאספו ולעקוב אחרי הביצועים והסטטוס של Oracle באמצעות Metrics Explorer או על ידי ייבוא של לוח בקרה בהתאמה אישית.

    הצגת מדדים ב-Metrics Explorer

    כדי לראות את מדדי Oracle ב-Metrics Explorer:

    1. במסוף Google Cloud , עוברים אל Monitoring.
    2. לוחצים על Metrics Explorer.
    3. בקטע Find resource type and metric (חיפוש סוג משאב ומדד), מבצעים את הפעולות הבאות:
      1. בשדה Resource type, בוחרים באפשרות VM Instance.
      2. בקטע מדד, בוחרים את המדדים של Oracle שרוצים להציג.

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

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

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

    אנחנו מספקים לכם לוח בקרה לדוגמה oracle-status-overview.json והוראות לייבוא שלו. בלוח הבקרה oracle-status-overview.json מוצגים תרשימי המדדים הבאים של Oracle:

    • פירוט הזמן של מסד הנתונים
    • השימוש בזיכרון של מסד הנתונים
    • סשנים פעילים בממוצע לפי מחלקת המתנה
    • קלט/פלט של דיסק
    • ניצול יחידת העיבוד המרכזית (CPU)
    • תנועה ברשת

    כדי לייבא את מרכז הבקרה oracle-status-overview.json:

    1. מוודאים שה-CLI של gcloud מותקן ועדכני. הוראות מפורטות זמינות במאמר בנושא התקנת ה-CLI של gcloud.

    2. מורידים את לוח הבקרה oracle-status-overview.json ממאגר GitHub של Agent for Compute Workloads:

      $ curl -H "Accept: application/vnd.github.v3.raw" -o oracle-status-overview.json https://api.github.com/repos/GoogleCloudPlatform/workloadagent/contents/observability/dashboards/oracle-status-overview.json

    3. מריצים את הפקודה הבאה כדי לייבא את לוח הבקרה:

      gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json

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

    מדדים נתמכים

    כל מדדי Oracle שנאספים על ידי Agent for Compute Workloads זמינים בנתיב workload.googleapis.com/oracle.

    בהמשך מופיעה רשימה של מדדי Oracle הנתמכים והנתיבים התואמים שלהם ב-Cloud Monitoring:

    • זיכרון תהליך

      • זיכרון התהליך (PGA) שנמצא בשימוש, בבייטים.

        process/pga_memory/total_used_size

      • זיכרון שהוקצה לתהליך (PGA), בבייטים

        process/pga_memory/total_allocated_size

    • זיכרון משותף

      • גודל הפריט בזיכרון המשותף (SGA), בבייטים

        process/sga_memory/size

    • אירועי המתנה של המערכת

      • מספר ההמתנות הכולל לסוג המתנה רשום

        sys_wait/count

      • הזמן הכולל שהוקדש לסוג ההמתנה הזה, בשניות

        sys_wait/time

      • סך ההמתנות ברקע בקטגוריית ההמתנה הזו

        sys_wait/foreground/count

      • זמן ההמתנה המצטבר ברקע של סוג ההמתנה הזה, בשניות

        sys_wait/foreground/time

    • משך הזמן שחלף במערכת

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

        sys_time/db_time

      • זמן המעבד שהוקצה לקריאות ברמת המשתמש במסד הנתונים, בשניות

        sys_time/db_cpu

      • משך הזמן שחלף מאז הפעלת הצהרות SQL

        sys_time/sql_execute_elapsed_time

      • כמות הזמן שחלף מאז שהתחילו לנתח הצהרות SQL

        sys_time/parse_time_elapsed

      • הזמן שחלף מאז הפעלת המהדר של PL/SQL

        sys_time/pl_sql_execution_elapsed_time

      • הזמן שחלף שבו נעשה שימוש בתהליכי רקע של מסד הנתונים, בשניות

        sys_time/background_elapsed_time

    • נתוני קלט/פלט

      • המספר הכולל של פעולות קריאה (קטנות + גדולות)

        iostat/read_ops_count

      • הספירה הכוללת של פעולות כתיבה (קטנות + גדולות)

        iostat/write_ops_count

      • המספר הכולל של בייטים שנקראו

        iostat/read_bytes_count

      • מספר הבייטים שנכתבו בסך הכול

        iostat/write_bytes_count

      • זמן אחזור ממוצע לכל פעולת קלט/פלט

        iostat/average_latency_seconds

    • קובצי נתונים

      • הגודל שהוקצה לקובץ הנתונים, בבייטים

        data_files/total_bytes

      • נפח האחסון של קובץ הנתונים בשימוש, בבייטים

        data_files/bytes_used

      • מקום פנוי בקובץ הנתונים, בבייטים

        data_files/available_bytes

      • מגבלת ההרחבה האוטומטית של קובץ הנתונים, בבייטים

        data_files/max_bytes

      • אחוז השימוש בקובץ הנתונים

        data_files/percent_used

    • מופע של מסד נתונים

      • זמן הפעולה של המופע, בשניות

        instance/uptime

      • סטטוס המכונה

        instance/status

        המדד הזה יכול לקבל את הערכים הבאים:

        UNKNOWN 0
        STARTED 1
        MOUNTED 2
        OPEN 3
        OPEN MIGRATE 4

      • מצב פתוח

        instance/db_open_mode

        המדד הזה יכול לקבל את הערכים הבאים:

        UNKNOWN 0
        MOUNTED 1
        READ WRITE 2
        READ ONLY 3
        READ ONLY WITH APPLY 4

    • Oracle Data Guard

      • משך ההשהיה לפני החלת הפעולה 'ביצוע מחדש', בשניות

        dataguard/apply_lag

      • משך ההשהיה של שידור חוזר, בשניות

        dataguard/transport_lag

    ניהול הסוכן

    הפעלה מחדש של הסוכן

    אם Agent for Compute Workloads מפסיק לפעול או שאתם מעדכנים את ההגדרה שלו, צריך להפעיל מחדש את הסוכן.

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

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

      sudo systemctl restart google-cloud-workload-agent

    בדיקת גרסת הסוכן

    כדי לבדוק את גרסת הסוכן:

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

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

      yum info google-cloud-workload-agent

    חיפוש עדכונים

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

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

      sudo yum check-update google-cloud-workload-agent

    עדכון הסוכן

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

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

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

      sudo yum --nogpgcheck update google-cloud-workload-agent

    צפייה ביומני הסוכן

    היומנים של Agent for Compute Workloads זמינים בכתובת /var/log/google-cloud-workload-agent.log.

    רמת הפירוט של היומן נשלטת על ידי הפרמטר log_level. ההגדרה DEBUG log level כוללת מידע נוסף לפתרון בעיות ספציפיות, אבל יוצרת יומנים גדולים משמעותית.

    כברירת מחדל, היומנים של Agent for Compute Workloads מופנים מחדש ממכונות ה-VM אל Cloud Logging.

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

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

      כניסה לדף Logs Explorer

    2. עוברים לחלונית שאילתה.

    3. בתפריט הנפתח Resources (משאבים), בוחרים באפשרות Global (גלובלי) ולוחצים על Apply (החלה).

    4. מזינים google-cloud-workload-agent בעורך השאילתות.

    5. לוחצים על Run query.

    אפשר לראות את היומנים שנוצרו על ידי הסוכן שפועל בכל מכונות ה-VM. אפשר לסנן את היומנים לפי מופע ספציפי.

    הגדרת יומנים של סוכנים ב-Cloud Logging

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

    1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

    2. פותחים את קובץ ההגדרות של הסוכן:

      /etc/google-cloud-workload-agent/configuration.json

    3. בנכס log_to_cloud, מעדכנים את הערך ל-false.

    4. שומרים את קובץ ההגדרות.

    5. מפעילים מחדש את הסוכן כדי שהשינוי ייכנס לתוקף.

    פתרון בעיות

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

    אין מספיק הרשאות IAM

    בעיה: ביומנים של Agent for Compute Workloads מופיעה שגיאה שמעידה על הרשאות IAM לא מספיקות.

    googleapi: Error 403: The client is not authorized to make this request.

    הסיבה: לחשבון השירות שבו הסוכן משתמש אין את הרשאות ה-IAM הנדרשות לגישה לממשקי ה-API של Google Cloud או סיסמה למשתמש Oracle ב-Secret Manager.

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

    היקפי ההרשאות לאימות לא מספיקים

    בעיה: ביומני של Agent for Compute Workloads מופיעים היקפי הרשאות לא מספיקים לאימות.

    googleapi: Error 403: Request had insufficient authentication scopes.

    הסיבה: לחשבון השירות שבו משתמש הסוכן אין את היקף הגישה הנדרש.

    פתרון: כדי לפתור את הבעיה, צריך להגדיר את היקפי הגישה של מכונת ה-VM לערך cloud-platform.

    מדדים לא מופיעים ב-Cloud Monitoring

    בעיה: מדדים מה-Agent for Compute Workloads לא מוצגים ב-Cloud Monitoring.

    הסיבה:

    אלה הסיבות האפשריות לבעיה הזו:

    • לחשבון השירות שבו משתמש Agent for Compute Workloads חסרות הרשאות ה-IAM הנדרשות.
    • למשתמש Oracle שבו הסוכן משתמש אין מספיק הרשאות לשליחת שאילתות לתצוגות הביצועים.
    • יש שגיאות בהגדרות של הסוכן.

    פתרון:

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

      1. נכנסים לדף VM instance details במסוף Google Cloud ורושמים את חשבון השירות שבו משתמשת המכונה שמריצה את הסוכן.
      2. עוברים לדף IAM ואדמין ומוודאים שלחשבון השירות יש את כל התפקידים וההרשאות הנדרשים שמפורטים בקטע דרישות מוקדמות. מקצים לחשבון השירות את התפקידים הנדרשים שחסרים.

    • כדי לפתור את הבעיה שקשורה להרשאות לא מספיקות של משתמש Oracle:

      1. מוודאים שלמשתמש Oracle יש את ההרשאות הנדרשות הבאות להפעלת שאילתות בתצוגות הביצועים:

        • SESSION
        • SELECT_CATALOG_ROLE
        • SYSDG

      2. מריצים את פקודת ה-SQL הבאה כדי להעניק את ההרשאות החסרות:

        -- Grant the "wlmagent" user the required permissions
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;

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

      1. משתמשים ב-SSH כדי להתחבר למופע של המכונה הווירטואלית.

      2. בודקים את היומנים של הסוכן כדי לזהות שגיאות או בעיות שמונעות את איסוף המדדים. אפשר למצוא את היומנים בכתובת /var/log/google-cloud-workload-agent.log.

        מחפשים שגיאות הרשאה, בעיות בהגדרות או בעיות בקישוריות.

      3. פותרים את השגיאות.

      4. מפעילים מחדש את הסוכן ובודקים אם איסוף המדדים מתחיל.

    טעינת קובץ ההגדרות נכשלה

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

    "Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown
field "{field_name}"

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

    האתחול של איסוף הנתונים נכשל

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

    "Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"

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