SAP HANA

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

מידע נוסף על HANA זמין במסמכי התיעוד של SAP HANA.

הערה: להתקנות חדשות, מומלץ להשתמש ב Google CloudAgent for SAP. הסוכן ל-SAP נדרש לכל עומסי העבודה של SAP ב- Google Cloud , כפי שנקבע על ידי SAP. השילוב של Ops Agent עם SAP HANA משכפל חלק מתכונות המעקב של Agent for SAP, אבל Agent for SAP הוא הפתרון המומלץ. מידע נוסף זמין Google Cloudבמדריך לתכנון של Agent for SAP.

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

כדי לאסוף נתוני טלמטריה של HANA, צריך להתקין את סוכן התפעול:

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

השילוב הזה תומך ב-HANA גרסה 2.0.

הגדרת מופע HANA

כדי לאסוף מדדים, למשתמש עם הרשאות צפייה צריך להיות SELECT גישה לתצוגות הרלוונטיות של המעקב. סקריפט ה-SQL הבא יוצר תפקיד של ניטור ומחיל אותו על משתמש ניטור אם הוא מופעל על ידי משתמש עם הרשאות מספיקות שמחובר למכונת SAP HANA.

--Create the user
CREATE RESTRICTED USER otel_monitoring_user PASSWORD ;
--Enable user login
ALTER USER otel_monitoring_user ENABLE CLIENT CONNECT;
--Create the monitoring role
CREATE ROLE OTEL_MONITORING;
--Grant permissions to the relevant views
GRANT CATALOG READ TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BACKUP_CATALOG TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BLOCKED_TRANSACTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CONNECTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_ALL_COLUMNS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DATABASE TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DISKS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_HOST_RESOURCE_UTILIZATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_LICENSES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_RS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_COMPONENT_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_REPLICATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_THREADS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_VOLUME_IO_TOTAL_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_WORKLOAD TO OTEL_MONITORING;
GRANT SELECT ON _SYS_STATISTICS.STATISTICS_CURRENT_ALERTS TO OTEL_MONITORING;
GRANT SELECT ON DUMMY TO OTEL_MONITORING;
--Add the OTEL_MONITOR role to the monitoring user
GRANT OTEL_MONITORING TO otel_monitoring_user;

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

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

הגדרה לדוגמה

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

# 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
logging:
  receivers:
    saphana:
      type: saphana
      include_paths:
      - /usr/sap/*/HDB*/*/trace/*.trc
      exclude_paths:
      - /usr/sap/*/HDB*/*/trace/nameserver_history*.trc
      - /usr/sap/*/HDB*/*/trace/nameserver*loads*.trc
      - /usr/sap/*/HDB*/*/trace/nameserver*executed_statements*.trc
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
metrics:
  receivers:
    saphana:
      type: saphana
      username: SYSTEM
      password: G00g3l21
      # 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>}
      endpoint: localhost:30015
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
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*
   

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

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

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

שדה	ברירת מחדל	תיאור
exclude_paths	[/usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver_history*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*loads*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*executed_statements*.trc]	רשימה של תבניות של נתיבים במערכת הקבצים שצריך להחריג מהקבוצה שתואמת ל-include_paths.
include_paths	[/usr/sap/*/HDB*/${HOSTNAME}/trace/*.trc]	רשימה של נתיבי מערכת קבצים לקריאה על ידי מעקב אחרי כל קובץ. אפשר להשתמש בתו כללי לחיפוש (*) בנתיבים.
record_log_file_path	false	אם הערך הוא true, הנתיב לקובץ הספציפי שממנו נרשם רשומת היומן מופיע ברשומת היומן של הפלט כערך של התווית agent.googleapis.com/log_file_path. כשמשתמשים בתו כללי, מתועד רק הנתיב של הקובץ שממנו התקבל הרשומה.
type		הערך חייב להיות saphana.
wildcard_refresh_interval	60s	המרווח שבו נתיבי קבצים עם תו כללי ב-include_paths מתרעננים. הערך הוא משך זמן, לדוגמה 30s או 2m. הנכס הזה יכול להיות שימושי כשקצב העברת הנתונים של הרישום ביומן גבוה, והקבצים ביומן מתחלפים מהר יותר מהמרווח שמוגדר כברירת מחדל.

מה נרשם ביומן

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

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

שדה	סוג	תיאור
jsonPayload.component	מחרוזת	רכיב SAP HANA
jsonPayload.connection_id	מספר	המזהה של החיבור שממנו נשלחה ההודעה, אם ההודעה נרשמה ביומן במסגרת חיבור
jsonPayload.message	מחרוזת	הודעה ביומן
jsonPayload.severity_flag	מחרוזת	רמת רשומת היומן
jsonPayload.thread_id	מספר	המזהה של השרשור שבו ההודעה נרשמת ביומן
jsonPayload.transaction_id	מספר	המזהה של העסקה שממנה נשלחה ההודעה, אם ההודעה נרשמה ביומן במסגרת עסקה
jsonPayload.update_transaction_id	מספר	המזהה של עסקת העדכון שממנה נשלחה ההודעה, אם ההודעה נרשמה ביומן במסגרת עסקת עדכון
severity	מחרוזת (LogSeverity)	רמת רשומת היומן (מתורגמת).
sourceLocation.file	מחרוזת	שם קובץ המקור
sourceLocation.line	מספר	שורה בקובץ המקור

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

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

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

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

שדה	ברירת מחדל	תיאור
ca_file		הנתיב לאישור CA. הלקוח מאמת את אישור השרת. אם העמודה ריקה, הנמען משתמש ב-CA הבסיסי של המערכת.
cert_file		נתיב לאישור TLS לשימוש בחיבורים שנדרש בהם mTLS.
collection_interval	60s	ערך של משך זמן, כמו 30s או 5m.
endpoint	localhost:30015	hostname:port שמשמש לחיבור למופע SAP HANA.
insecure	true	ההגדרה קובעת אם להשתמש בחיבור TLS מאובטח. אם המדיניות מוגדרת לערך false, פרוטוקול TLS מופעל.
insecure_skip_verify	false	ההגדרה קובעת אם לדלג על אימות האישור או לא. אם insecure מוגדר כ-true, הערך insecure_skip_verify לא נמצא בשימוש.
key_file		הנתיב למפתח ה-TLS שבו יש להשתמש לחיבורים שנדרש בהם mTLS.
password		הסיסמה שמשמשת לחיבור למופע.
type		הערך חייב להיות saphana.
username		שם המשתמש שמשמש לחיבור למופע.

מה נבדק

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

סוג המדד
סוג, סוג משאבים במעקב	תוויות
workload.googleapis.com/saphana.alert.count
GAUGE, INT64 gce_instance	rating
workload.googleapis.com/saphana.backup.latest
GAUGE, INT64 gce_instance
workload.googleapis.com/saphana.column.memory.used
GAUGE, INT64 gce_instance	host subtype type
workload.googleapis.com/saphana.component.memory.used
GAUGE, INT64 gce_instance	component host
workload.googleapis.com/saphana.connection.count
GAUGE, INT64 gce_instance	host status
workload.googleapis.com/saphana.cpu.used
CUMULATIVE, INT64 gce_instance	host type
workload.googleapis.com/saphana.disk.size.current
GAUGE, INT64 gce_instance	host path state usage_type
workload.googleapis.com/saphana.host.memory.current
GAUGE, INT64 gce_instance	host state
workload.googleapis.com/saphana.host.swap.current
GAUGE, INT64 gce_instance	host state
workload.googleapis.com/saphana.instance.code_size
GAUGE, INT64 gce_instance	host
workload.googleapis.com/saphana.instance.memory.current
GAUGE, INT64 gce_instance	host state
workload.googleapis.com/saphana.instance.memory.shared.allocated
GAUGE, INT64 gce_instance	host
workload.googleapis.com/saphana.instance.memory.used.peak
GAUGE, INT64 gce_instance	host
workload.googleapis.com/saphana.license.expiration.time
GAUGE, INT64 gce_instance	product system
workload.googleapis.com/saphana.license.limit
GAUGE, INT64 gce_instance	product system
workload.googleapis.com/saphana.license.peak
GAUGE, INT64 gce_instance	product system
workload.googleapis.com/saphana.network.request.average_time
GAUGE, DOUBLE gce_instance	host
workload.googleapis.com/saphana.network.request.count
GAUGE, INT64 gce_instance	host state
workload.googleapis.com/saphana.network.request.finished.count
CUMULATIVE, INT64 gce_instance	host type
workload.googleapis.com/saphana.replication.average_time
GAUGE, DOUBLE gce_instance	mode port primary secondary
workload.googleapis.com/saphana.replication.backlog.size
GAUGE, INT64 gce_instance	mode port primary secondary
workload.googleapis.com/saphana.replication.backlog.time
GAUGE, INT64 gce_instance	mode port primary secondary
workload.googleapis.com/saphana.row_store.memory.used
GAUGE, INT64 gce_instance	host type
workload.googleapis.com/saphana.schema.memory.used.current
GAUGE, INT64 gce_instance	host schema type
workload.googleapis.com/saphana.schema.memory.used.max
GAUGE, INT64 gce_instance	host schema
workload.googleapis.com/saphana.schema.operation.count
CUMULATIVE, INT64 gce_instance	host schema type
workload.googleapis.com/saphana.schema.record.compressed.count
GAUGE, INT64 gce_instance	host schema
workload.googleapis.com/saphana.schema.record.count
GAUGE, INT64 gce_instance	host schema type
workload.googleapis.com/saphana.service.code_size
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.count
GAUGE, INT64 gce_instance	host status
workload.googleapis.com/saphana.service.memory.compactors.allocated
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.memory.compactors.freeable
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.memory.effective_limit
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.memory.heap.current
GAUGE, INT64 gce_instance	host service state
workload.googleapis.com/saphana.service.memory.limit
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.memory.shared.current
GAUGE, INT64 gce_instance	host service state
workload.googleapis.com/saphana.service.memory.used
GAUGE, INT64 gce_instance	host service type
workload.googleapis.com/saphana.service.stack_size
GAUGE, INT64 gce_instance	host service
workload.googleapis.com/saphana.service.thread.count
GAUGE, INT64 gce_instance	host status
workload.googleapis.com/saphana.transaction.blocked
GAUGE, INT64 gce_instance	host
workload.googleapis.com/saphana.transaction.count
CUMULATIVE, INT64 gce_instance	host type
workload.googleapis.com/saphana.volume.operation.count
CUMULATIVE, INT64 gce_instance	host path type usage_type
workload.googleapis.com/saphana.volume.operation.size
CUMULATIVE, INT64 gce_instance	host path type usage_type
workload.googleapis.com/saphana.volume.operation.time
CUMULATIVE, INT64 gce_instance	host path type usage_type

אימות ההגדרה

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

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

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

   כניסה אל Logs Explorer

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

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

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

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

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

   כניסה אל Metrics Explorer

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

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

   {"workload.googleapis.com/saphana.connection.count", monitored_resource="gce_instance"}
   

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

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

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

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

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

   מעבר אל מרכזי בקרה

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

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

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

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

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

   עוברים אל Integrations

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

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

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

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

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

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

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

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

   עוברים אל Integrations

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

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

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

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

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

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

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

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

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