Guida all'installazione e al funzionamento dell'agente di monitoraggio per SAP HANA V2.0

Questa guida fornisce istruzioni per l'installazione, il funzionamento e la risoluzione dei problemi della versione 2.0 dell'agente di monitoraggio Google Cloud per SAP HANA.

Per una panoramica dell'agente di monitoraggio per SAP HANA e delle sue opzioni, consulta la Guida alla pianificazione dell'agente Monitoring per SAP HANA V2.0.

Prerequisiti

L'agente di monitoraggio per SAP HANA richiede i driver di connessione SAP HANA e una versione specifica di Java Runtime Environment (JRE).

Se il server su cui stai installando l'agente ha accesso a internet, l'agente scarica automaticamente i file durante l'installazione.

Se il server non ha accesso a Internet, puoi caricare i file sul server autonomamente.

Se devi caricarli personalmente, prima di installare l'agente, carica i seguenti file nella directory /tmp/gcpsapdeps:

https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_linux-x64_bin.tar.gz

https://repo1.maven.org/maven2/com/sap/cloud/db/jdbc/ngdbc/2.11.14/ngdbc-2.11.14.jar

Inoltre, questa guida presuppone che tu abbia:

Un Account Google.
Un progetto Google Cloud.
Un account di fatturazione Google Cloud.
Una o più istanze di SAP HANA di cui è stato eseguito il deployment. Per informazioni sul deployment di SAP HANA su Google Cloud, consulta la Guida al deployment di SAP HANA.

Impostazione dei ruoli IAM richiesti

Come minimo, l'account di servizio utilizzato dall'agente di monitoraggio per SAP HANA deve includere il ruolo Monitoring Metric Writer. In caso contrario, devi concedere il ruolo Monitoring Metric Writer all'account di servizio.

Inoltre, se utilizzi Secret Manager per archiviare la password utente del database di sistema SAP HANA, l'account di servizio deve includere il ruolo Secret Manager Secret Accessor e le istanze VM devono includere l'ambito di accesso cloud-platform.

Per aggiungere i ruoli richiesti al tuo account di servizio:

Nella console Google Cloud, vai alla pagina IAM di IAM e amministrazione.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
Identifica l'account di servizio a cui vuoi aggiungere i ruoli IAM.
- Se l'account di servizio non è già nell'elenco delle entità, non avrà alcun ruolo assegnato. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già nell'elenco delle entità, significa che dispone di ruoli esistenti. Fai clic sul pulsante Modifica entità in corrispondenza dell'account di servizio che vuoi modificare.
Fai clic su Aggiungi un altro ruolo e assicurati che i ruoli seguenti siano assegnati al tuo account di servizio:
- Monitoring > Writer metriche Monitoring
- Secret Manager > Funzione di accesso ai secret di Secret Manager
Fai clic su Aggiungi o Salva per assegnare i ruoli al tuo account di servizio.

Per informazioni su come impostare gli ambiti di accesso per un'istanza VM, consulta Modifica dell'account di servizio e degli ambiti di accesso per un'istanza.

Per ulteriori informazioni sui ruoli e sugli ambiti IAM necessari per accedere a Secret Manager, consulta Controllo dell'accesso di Secret Manager.

Installazione dell'agente di monitoraggio per SAP HANA

Aggiungere il repository RPM di Google Cloud all'elenco dei repository del sistema operativo

Devi aggiungere l'URL del repository RPM di Google Cloud per l'agente all'elenco dei repository di pacchetti per il sistema operativo. La modalità di aggiunta di un repository varia a seconda che utilizzi un sistema operativo Red Hat o SUSE.

Aggiunta di un repository a RHEL

Per aggiungere il repository RPM di Google Cloud a RHEL, seleziona la tua versione e segui la procedura:

RHEL 7

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
[google-saphanamonitoring-agent]
name=Google SAP HANA Monitoring Agent
baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el7-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
EOM

RHEL 8

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
[google-saphanamonitoring-agent]
name=Google SAP HANA Monitoring Agent
baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el8-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
EOM

Aggiunta di un repository a SLES

Per aggiungere il repository RPM di Google Cloud a SLES, seleziona la tua versione e segui la procedura:

SLES 12

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles12-\$basearch google-saphanamonitoring-agent

SLES 15

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles15-\$basearch google-saphanamonitoring-agent

Installazione dell'agente

Puoi installare l'agente di monitoraggio per SAP HANA utilizzando il gestore di pacchetti del sistema operativo.

Per installare l'agente, seleziona il tuo sistema operativo e segui la procedura:

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

RHEL

sudo yum install google-saphanamonitoring-agent

SLES

sudo zypper --no-gpg-checks install google-saphanamonitoring-agent

L'agente è installato nella directory /usr/sap/google-saphanamonitoring-agent.

Configurazione dell'agente

Per configurare l'agente, modifica il file di configurazione dell'agente: /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml.

Valori delle proprietà server rilevati automaticamente

Per impostazione predefinita, la sezione cloud_properties nel file configuration.yaml viene commentata, come mostrato nell'esempio seguente, e l'agente di monitoraggio per SAP HANA utilizza l'ID progetto, l'ID istanza e la zona dell'istanza VM su cui è in esecuzione l'agente.

  # cloud_properties:
     # project_id: MONITORED_INSTANCE_PROJECT_ID
     # instance_id: MONITORED_VM_ID
     # zone: MONITORED_VM_ZONE

Se l'agente è in esecuzione sulla stessa VM di SAP HANA, puoi lasciare commentato la sezione cloud_properties.

Se l'agente è in esecuzione su una VM diversa da SAP HANA, devi rimuovere il carattere di commento # da ogni riga della sezione cloud_properties e aggiornare le proprietà project_id, instance_id e zone con l'ID progetto, l'ID istanza e la zona della VM host SAP HANA.

Se SAP HANA è in esecuzione su un server Bare Metal Solution, devi rimuovere il carattere di commento, #, solo dalle righe cloud_properties e project_id e specificare l'ID progetto del progetto che stai utilizzando con Bare Metal Solution. Lascia senza commenti le proprietà instance_id e zone.

Valori delle proprietà SAP HANA rilevati automaticamente

Per impostazione predefinita, la proprietà sid nel file configuration.yaml viene commentata e l'agente recupera l'ID di sistema SAP HANA (SID) dalla tabella M_DATABASE di SAP HANA. Se devi specificare un SID diverso, rimuovi il carattere del commento dalla riga sid e specifica il SID necessario.

Procedura di configurazione

I passaggi seguenti specificano le proprietà di configurazione di uso comune. Per le descrizioni di tutte le proprietà di configurazione, consulta Descrizioni delle proprietà di configurazione.

Apri il file di configurazione per la modifica utilizzando il tuo editor di testo preferito. Ad esempio:
```
sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Facoltativamente, in gcloud_auth, rimuovi il carattere di commento # e specifica il percorso di un file JSON contenente la chiave di un account di servizio IAM per l'agente. Ad esempio:

gcloud_auth:
# If defined this service account will be used for API calls or else the default VM credentials
# will be used.
service_account_json: /usr/sap/google-saphanamonitoring-agent/auth/example-project-id-abcdef123456.json

Specifica una o più istanze SAP HANA che l'agente deve monitorare.

Per specificare più di un database SAP HANA, crea un nuovo insieme di proprietà copiando tutte le proprietà hana_instances applicabili da - name a trust_store_secret_name. Devi copiare le proprietà SSL, certificato, archivio chiavi e trustore solo se l'istanza SAP HANA aggiuntiva le utilizza. Incolla il set aggiuntivo di proprietà dell'istanza subito dopo il primo insieme e prima di queries.

Per definire un'istanza SAP HANA:
1. Specifica il nome dell'host su cui è in esecuzione l'istanza SAP HANA. Questo valore viene visualizzato nei log e in Monitoring. Ad esempio:
```
- name: example-hana-vm
```
2. Specifica l'indirizzo IP dell'host su cui è in esecuzione l'istanza SAP HANA.
  - Se l'istanza SAP HANA è in esecuzione su una VM host diversa dall'agente, specifica l'indirizzo IP interno della VM host. Ad esempio:
```
host: 10.1.0.100
```
  - Se l'istanza SAP HANA è in esecuzione su un host che non si trova nello stesso progetto Google Cloud dell'agente, specifica l'indirizzo IP pubblico della VM host.
  - Se l'agente è in esecuzione sullo stesso host di SAP HANA, puoi accettare il valore predefinito, ovvero l'indirizzo IP di loopback localhost, 127.0.0.1.
3. Specifica la porta su cui l'istanza SAP HANA accetta le query. Per il primo o l'unico database tenant, la porta è 3nn15, dove nn è il numero di istanza di SAP HANA.
```
port: 30015
```
4. Specifica l'account utente SAP HANA che l'agente deve utilizzare per le query su SAP HANA. Per impostazione predefinita, l'account utente SYSTEM è specificato:
```
user: SYSTEM
```
5. Specifica la password per l'account utente SAP HANA che l'agente deve utilizzare per le query su SAP HANA. Ad esempio:
```
password: TempPa55word
```
6. Se il sistema SAP HANA utilizza Transport Layer Secure (TLS)/Secure Sockets Layer (SSL), abilita il supporto SSL:
```
enable_ssl: true
```
7. Per convalidare i certificati quando SAP HANA utilizza TLS/SSL, abilita il controllo dei certificati e specifica le proprietà del nome del certificato, dell'archivio chiavi e del trustore, in base alle esigenze.
```
validate_certificate: true
```
  Per una descrizione delle proprietà nome, archivio chiavi e trustore del certificato, consulta Descrizioni delle proprietà di configurazione.
Salva e chiudi il file configuration.yaml.

Descrizioni delle proprietà di configurazione

La seguente tabella mostra tutte le proprietà che puoi utilizzare per definire le istanze SAP HANA, le connessioni, il supporto TLS/SSL e la convalida dei certificati.

Ad eccezione di sample_interval e query_timeout, che definiscono i valori predefiniti globali per le query, tutte le altre proprietà utilizzate per definire o attivare singole query sono documentate nella guida alla pianificazione dell'agente Monitoring per SAP HANA.

Proprietà	Tipo di dati	Descrizione
`sample_interval`	Int	Definisce l'intervallo predefinito, in secondi, tra le query. Il valore specificato qui può essere sostituito per una singola query specificando `sample_interval` nella definizione della query. Il valore predefinito è `300` (5 minuti).
`query_timeout`	Int	Il tempo consentito per l'esecuzione della query in secondi. Il valore predefinito è 5 minuti.
`cloud_properties`	Proprietà che identificano l'ambiente in cui è in esecuzione l'agente. Questi valori vengono rilevati automaticamente, ma possono essere modificati.
`project_id`	Stringa	L'ID del progetto Google Cloud in cui è in esecuzione SAP HANA. In Monitoring, questo valore è un'etichetta di risorsa che puoi utilizzare per filtrare i dati. Specifica questa proprietà se SAP HANA è in esecuzione su una VM diversa dall'agente o su un server Bare Metal Solution. Per impostazione predefinita, quando l'agente viene eseguito sulla stessa VM di SAP HANA, rileva automaticamente l'ID progetto. Puoi ignorare il comportamento predefinito specificando un valore di proprietà.
`instance_id`	Stringa	Quando SAP HANA è in esecuzione su una VM di Compute Engine diversa dall'agente, specifica il numero ID dell'istanza della VM host SAP HANA. In Monitoring, questo valore è un'etichetta di risorsa che puoi utilizzare per filtrare i dati. Se SAP HANA è in esecuzione su un server Bare Metal Solution, lascia sempre `instance_id` commentato. Per impostazione predefinita, l'agente utilizza l'ID istanza della VM su cui è installato.
`zone`	Stringa	Quando SAP HANA è in esecuzione su una VM di Compute Engine in una zona diversa da quella dell'agente, specifica la zona della VM host SAP HANA. In Monitoring, questo valore è un'etichetta di risorsa che puoi utilizzare per filtrare i dati. Se SAP HANA è in esecuzione su un server Bare Metal Solution, lascia sempre `zone` commentato. Per impostazione predefinita, l'agente utilizza la zona della VM su cui è installato.
`gcloud_auth`	Proprietà relative all'account di servizio utilizzato dall'agente per la gestione di identità e accessi.
`service_account_json`	Stringa	Specifica il percorso di un file JSON contenente la chiave di un account di servizio personalizzato che hai creato. Google Cloud utilizza l'account di servizio per autenticare l'agente e per determinare a quali API e risorse Google Cloud l'agente è autorizzato ad accedere. Se `service_account_json` viene omesso, l'agente utilizza l'account di servizio della VM host.
`hana_instances`	Proprietà che identificano un database SAP HANA da monitorare. Per specificare più di un database SAP HANA, crea un nuovo set di proprietà copiando le proprietà dell'istanza esistenti da `- name` a `enable_ssl`, incluse, e incollandole immediatamente dopo il primo set. Definisci il database aggiuntivo con il nuovo insieme di proprietà.
`- name`	Stringa	Il nome dell'host su cui è in esecuzione SAP HANA. Questo valore identifica l'istanza SAP HANA. In Monitoring, questo valore è un'etichetta di metrica che puoi utilizzare per filtrare i dati. Se stai monitorando più di un database, modifica questo valore per distinguere i database.
`sid`	Stringa	Una proprietà facoltativa che specifica il SID dell'istanza SAP HANA che sta monitorando l'agente. Normalmente l'agente recupera questo valore da SAP HANA automaticamente, quindi non è necessario specificarlo. Se devi specificare un valore diverso o l'agente non rileva automaticamente il SID, rimuovi il commento dalla proprietà `sid` e specifica il valore che ti serve.
`host`	Stringa	L'indirizzo IP dell'host SAP HANA. Se l'agente è in esecuzione sullo stesso host di SAP HANA, puoi accettare il valore predefinito, ovvero l'indirizzo IP di loopback localhost.
`port`	Int	Il numero di porta del server SAP HANA, come definito da SAP. Per il primo o l'unico database tenant, specifica `3nn15`, dove `nn` è il numero di istanza SAP HANA. Per maggiori informazioni sulle porte SAP HANA, consulta Porte TCP/IP di tutti i prodotti SAP.
`connections`	Int	Per il pool di connessioni, il numero di connessioni da mantenere nel pool di connessioni. Non modificare questa proprietà a meno che non venga richiesto dall'Assistenza clienti Google Cloud.
`user`	Stringa	L'account utente del database SAP HANA che l'agente utilizza per eseguire query su SAP HANA. `SYSTEM` è l'impostazione predefinita.
`password`	Stringa	La password dell'account utente del database che l'agente di monitoraggio utilizza per eseguire query su SAP HANA. Non specificare una password se utilizzi Secret Manager per archiviare le credenziali utente del database.
`secret_name`	Stringa	Se utilizzi Secret Manager per archiviare le credenziali utente del database, specifica il nome del secret che contiene le credenziali di sicurezza. Importante: il secret e la VM host devono esistere nello stesso progetto Google Cloud.
`enable_ssl`	Booleano	Specifica se SSL o TSL è abilitato in SAP HANA. I valori validi sono `true` o `false`.
`validate_certificate`	Booleano	Specifica se l'agente controlla il certificato del server. I valori validi sono `true` o `false`.
`host_name_in_certificate`		Specifica il nome host SAP HANA contenuto nel certificato. Questa proprietà è obbligatoria quando l'agente di monitoraggio per SAP HANA è in esecuzione sulla stessa VM host di SAP HANA e la VM host SAP HANA utilizza `localhost` per completare la connessione tra l'agente e la VM host anziché il nome host effettivo.
`key_store`		Specifica il percorso di un archivio chiavi Java JKS o PKCS12. Se questa proprietà non è specificata, l'agente di monitoraggio per SAP HANA utilizza il valore predefinito di JVM. Se l'archivio chiavi è protetto da password, è necessario specificare `key_store_password` o `key_store_secret_name`.
`key_store_password`		Se un archivio chiavi è protetto da password, specifica una password in testo normale per l'archivio chiavi. La specifica di `key_store_password` si escludono a vicenda con la specifica di `key_store_secret_name`.
`key_store_secret_name`		Quando un archivio chiavi è protetto da password, specifica il nome di un secret in Secret Manager contenente la password per l'archivio chiavi. La specifica di `key_store_secret_name` si escludono a vicenda con la specifica di `key_store_password`. Importante: il secret e la VM host devono esistere nello stesso progetto Google Cloud.
`trust_store`		Specifica il percorso del file JKS dell'archivio attendibilità contenente i certificati pubblici del server SAP HANA. In genere, l'archivio attendibilità contiene il certificato radice o il certificato dell'autorità di certificazione che ha firmato i certificati del server SAP HANA. Se trust_store viene omesso, l'agente utilizza l'archivio di attendibilità predefinito della JVM.
`trust_store_password`		Se un archivio attendibilità è protetto da password, specifica una password in testo normale per l'archivio attendibilità. La specifica di `trust_store_password` si escludono a vicenda con la specifica di `trust_store_secret_name`.
`trust_store_secret_name`		Quando un archivio attendibilità è protetto da password, specifica il nome di un secret in Secret Manager contenente la password per l'archivio attendibilità. La specifica di `trust_store_secret_name` si escludono a vicenda con la specifica di `trust_store_password`. Importante: il secret e la VM host devono esistere nello stesso progetto Google Cloud.

Abilita l'agente

Dopo aver configurato l'agente di monitoraggio per SAP HANA, ma prima di avviarlo, abilita l'agente come servizio systemd in modo che il servizio venga riavviato ogni volta che l'istanza VM viene riavviata.

Per abilitare l'agente:

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo systemctl enable google-saphanamonitoring-agent

Dovresti vedere un output simile al seguente esempio:

Created symlink /etc/systemd/system/multi-user.target.wants/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
Created symlink /etc/systemd/system/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.

Avvia l'agente

Per avviare l'agente:

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo systemctl start google-saphanamonitoring-agent

Controlla lo stato dell'agente:

sudo systemctl status google-saphanamonitoring-agent

Se l'avvio ha esito positivo, dopo alcuni secondi l'agente inizia a eseguire query su SAP HANA e a inviare le metriche a Monitoring.

Per informazioni sulla visualizzazione delle metriche in Monitoring, consulta Installare la dashboard personalizzata per visualizzare le metriche.

Controllo dei log

Per controllare i log, esegui il seguente problema:

tail -n 100 -f /var/log/google-saphanamonitoring-agent.log

All'avvio, l'agente registra gli eventi di avvio nei log. L'avvio, la pianificazione delle query e l'invio delle metriche a Monitoring vengono registrati nei log.

L'esempio seguente mostra i log di avvio e le voci di log per la prima query riuscita in SAP HANA.

2021-04-26T20:42:53.392UTC [INFO] ******  Starting Google SAP HANA Custom Metrics Agent ******
2021-04-26T20:42:53.413UTC [INFO] Controller initializing...
2021-04-26T20:42:53.414UTC [INFO] Configuring dependencies...
2021-04-26T20:42:53.677UTC [INFO] Configuration of dependencies complete.
2021-04-26T20:42:53.678UTC [INFO] Configuration loading...
2021-04-26T20:42:53.704UTC [INFO] Loading system level metric definitions...
2021-04-26T20:42:53.767UTC [INFO] Loading conf/configuration.yaml...
2021-04-26T20:42:53.836UTC [INFO] Default Cloud Properties: projectId=example-project-id, instanceId=8254335046206112691, zone=us-central1-f
2021-04-26T20:42:53.843UTC [INFO] No "cloud_properties" field found in the config file, so using default cloud properties.
2021-04-26T20:42:53.850UTC [INFO] Configuration loaded and validated.
2021-04-26T20:42:53.865UTC [INFO] Configuration load complete.
2021-04-26T20:42:53.865UTC [INFO] Controller initialization complete
2021-04-26T20:42:53.865UTC [INFO] Starting sampling of HANA metrics...
2021-04-26T20:42:53.875UTC [INFO] Creating connection pool of size 10 for SAP HANA instance "example-hana-vm"
2021-04-26T20:42:54.289UTC [INFO] The SAP HANA agent has completed initial setup. Metrics will start being sent to Cloud Monitoring in 30 seconds.
2021-04-26T20:43:24.278UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.281UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.294UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Scheduling another execution for query "replication_query" and instance "example-hana-vm" in 300 seconds

Arresto dell'agente in corso...

Se aggiungi una query personalizzata o modifichi in altro modo la configurazione dell'agente, devi arrestare e avviare l'agente prima che la nuova query o altre modifiche alla configurazione abbiano effetto.

Interrompi l'agente:

sudo systemctl stop google-saphanamonitoring-agent

Riavvia l'agente:

sudo systemctl start google-saphanamonitoring-agent

Installa la dashboard personalizzata per visualizzare le metriche

Per installare la dashboard personalizzata SAP HANA dal repository GitHub in Monitoring, segui questi passaggi:

Apri Cloud Shell:

Vai a Cloud Shell

In Cloud Shell, clona o scarica il repository:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git

In Cloud Shell, installa la dashboard performance.json di SAP HANA:

gcloud monitoring dashboards create \
--config-from-file=monitoring-dashboard-samples/dashboards/sap-hana/performance.json

La dashboard "SAP HANA Performance" viene aggiunta alle dashboard disponibili nel tuo progetto Google Cloud. Per vedere la dashboard, segui le istruzioni in Visualizzazione della dashboard installata.

Per ulteriori informazioni, vedi:

Visualizzazione della dashboard installata

Il file performance.json nel repository crea una nuova dashboard personalizzata dal titolo "SAP HANA Performance".

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:

Vai a Monitoring
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic su SAP HANA Performance nell'elenco. Se hai molte dashboard, puoi filtrarle in base alle dashboard personalizzate o in base al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzazione delle dashboard personalizzate.

La seguente acquisizione della schermata mostra parte della dashboard personalizzata per SAP HANA in Monitoring.

L'acquisizione dello schermo mostra i due grafici principali della dashboard
Perfromance SAP HANA personalizzata in Monitoring

Aggiornamento dell'agente di monitoraggio per SAP HANA

Per assicurarti di disporre della versione più recente dell'agente di monitoraggio per SAP HANA, verifica periodicamente la presenza di aggiornamenti. Gli aggiornamenti vengono annunciati nella pagina Note di rilascio di SAP su Google Cloud.

Verifica aggiornamenti...

Seleziona il sistema operativo:

RHEL

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo yum check-update google-saphanamonitoring-agent

SLES

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo zypper list-updates -r google-saphanamonitoring-agent

Installazione di un aggiornamento

Seleziona il sistema operativo:

RHEL

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo yum update google-saphanamonitoring-agent

SLES

Stabilisci una connessione SSH con la VM host.

Esegui il seguente comando:

sudo zypper --no-gpg-checks update google-saphanamonitoring-agent

Risoluzione dei problemi

Le sezioni seguenti illustrano la procedura da seguire in caso di problemi con l'installazione, le query o l'invio delle metriche a Monitoring.

Installazione non riuscita

Assicurati di utilizzare un sistema operativo supportato dall'agente di monitoraggio per SAP HANA. Per saperne di più, consulta la sezione Sistemi operativi supportati.

Controlla se nella shell sono presenti messaggi di errore che hai utilizzato per installare l'agente.

Conferma che il repository RPM di Google Cloud per l'agente sia stato aggiunto all'elenco dei repository del sistema operativo, come descritto in Aggiungere il repository RPM di Google Cloud all'elenco dei repository del sistema operativo.

Query predefinite con esito negativo

Sulla VM host, verifica se esistono messaggi di errore nel file di log, /var/log/google-saphanamonitoring-agent.log.

Nella VM host, verifica che sia specificata la porta corretta nella proprietà port di ogni definizione di istanza SAP HANA nel file configuration.yaml. Per informazioni da SAP su quali porte utilizzare per le query SQL SAP HANA, consulta Porte TCP/IP di tutti i prodotti SAP.

Assicurati che l'utente del tuo database SAP HANA abbia accesso alle seguenti viste del sistema SAP HANA:

M_CONNECTIONS
M_CS_ALL_COLUMNS
M_CS_TABLES
M_HOST_RESOURCE_UTILIZATION
M_RS_TABLES
M_SERVICE_COMPONENT_MEMORY
M_SERVICE_MEMORY
M_SERVICE_REPLICATION
M_WORKLOAD
STATISTICS_CURRENT_ALERTS visualizzazione dello schema _SYS_STATISTICS

Le metriche non vengono inviate a Monitoring

Sulla VM host, verifica se esistono messaggi di errore nel file di log, /var/log/google-saphanamonitoring-agent.log.

Se l'agente non utilizza l'account di servizio di una VM host, verifica che il percorso della chiave dell'account di servizio JSON sia specificato correttamente nella proprietà service_account_json nel file configuration.yaml.

Nella home page IAM e amministrazione, assicurati che l'account di servizio utilizzato dall'agente abbia il ruolo Monitoring Metric Writer (roles/monitoring.metricWriter). Per ulteriori informazioni, consulta Impostazione dei ruoli IAM richiesti.

Ottenere assistenza per l'agente di monitoraggio per SAP HANA

Se hai bisogno di aiuto per risolvere un problema con l'agente di monitoraggio per SAP HANA, raccogli le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta Informazioni di diagnostica sull'agente Monitoring per SAP HANA.

Assistenza

In caso di problemi con l'infrastruttura o i servizi Google Cloud, contatta l'assistenza clienti. Puoi trovare le informazioni di contatto nella pagina Panoramica dell'assistenza nella console Google Cloud. Se l'assistenza clienti stabilisce che un problema risiede nei tuoi sistemi SAP, ti indirizzerà all'assistenza SAP.

Per problemi relativi ai prodotti SAP, registra la tua richiesta di assistenza con l'assistenza SAP. SAP valuta il ticket di assistenza e, se sembra trattarsi di un problema dell'infrastruttura di Google Cloud, lo trasferisce al componente Google Cloud BC-OP-LNX-GOOGLE o BC-OP-NT-GOOGLE.

Requisiti per l'assistenza

Prima di poter ricevere assistenza per i sistemi SAP, nonché per l'infrastruttura e i servizi Google Cloud che utilizzano, devi soddisfare i requisiti minimi del piano di assistenza.

Per ulteriori informazioni sui requisiti minimi di assistenza per SAP su Google Cloud, consulta:

Ricevere assistenza per SAP su Google Cloud
SAP Note 2456406 - SAP on Google Cloud Platform: Support Prerequisites (È richiesto un account utente SAP)

Passaggi successivi

Scopri di più su Cloud Monitoring.