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 Monitoring 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 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, la presente 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.
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 gli sono stati assegnati ruoli. 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 saperne di più 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
Aggiungi il repository RPM di Google Cloud all'elenco di 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. Il modo in cui aggiungi un repository è diverso a seconda che utilizzi un sistema operativo Red Hat o un 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 comando seguente:
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 comando seguente:
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 comando seguente:
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 comando seguente:
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 comando seguente:
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
Puoi configurare l'agente modificando il file di configurazione dell'agente:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml.
Valori delle proprietà server che vengono rilevati automaticamente
Per impostazione predefinita, la sezione cloud_properties nel file configuration.yaml è 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 commentata 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 # soltanto dalle righe cloud_properties e project_id e specificare l'ID del progetto che stai utilizzando con Bare Metal Solution. Lascia senza commenti le proprietà instance_id e zone.
Valori delle proprietà SAP HANA che vengono 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 SAP HANA M_DATABASE. Se devi specificare un SID diverso,
rimuovi il carattere del commento dalla riga sid e specifica il SID
di cui hai bisogno.
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 da modificare utilizzando l'editor di testo che preferisci. Ad esempio:
sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Facoltativamente, in
gcloud_auth, rimuovi il carattere del commento#e specifica il percorso di un file JSON contenente la chiave per 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 dovrà monitorare.
Per specificare più di un database SAP HANA, crea un nuovo insieme di proprietà copiando tutte le proprietà
hana_instancesapplicabili da- nameatrust_store_secret_name. Devi copiare le proprietà SSL, certificato, archivio chiavi e trustore solo se l'istanza SAP HANA aggiuntiva le utilizza. Incolla l'insieme aggiuntivo di proprietà dell'istanza subito dopo il primo set e prima diqueries.Per definire un'istanza SAP HANA:
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
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 rispetto all'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.
Specifica la porta su cui l'istanza SAP HANA accetta le query. Per il primo o unico database tenant, la porta è
3nn15, dove nn è il numero di istanza di SAP HANA.port: 30015
Specifica l'account utente SAP HANA che l'agente deve utilizzare per eseguire le query su SAP HANA. Per impostazione predefinita, l'account utente
SYSTEMè specificato:user: SYSTEM
Specifica la password per l'account utente SAP HANA che l'agente deve utilizzare per eseguire le query su SAP HANA. Ad esempio:
password: TempPa55word
Se il sistema SAP HANA utilizza Transport Layer Secure (TLS)/Secure Sockets Layer (SSL), abilita il supporto SSL:
enable_ssl: true
Per convalidare i certificati quando SAP HANA utilizza TLS/SSL, attiva il controllo dei certificati e specifica il nome del certificato, l'archivio chiavi e le proprietà trustore, se necessario.
validate_certificate: true
Per una descrizione del nome del certificato, dell'archivio chiavi e delle proprietà trustore, consulta le descrizioni delle proprietà di configurazione.
Salva e chiudi il file
configuration.yaml.
Descrizioni delle proprietà di configurazione
La tabella seguente mostra tutte le proprietà che puoi utilizzare per definire istanze e connessioni SAP HANA, supporto TLS/SSL e supporto della convalida dei certificati.
Ad eccezione di sample_interval e query_timeout, che definiscono valori predefiniti globali
per le query, tutte le altre proprietà utilizzate per definire o abilitare 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 una query e l'altra.
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 è espresso 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 |
String |
L'ID del progetto Google Cloud in cui è in esecuzione SAP HANA. In Monitoring, questo valore è un'etichetta della 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. Quando l'agente viene eseguito sulla stessa VM di SAP HANA, per impostazione predefinita, rileva automaticamente l'ID progetto. Puoi eseguire l'override del comportamento predefinito specificando un valore della proprietà. |
instance_id |
String |
Quando SAP HANA è in esecuzione su una VM di Compute Engine diversa rispetto all'agente, specifica il numero ID istanza della VM host SAP HANA. In Monitoring, questo valore è un'etichetta della risorsa che puoi utilizzare per filtrare i dati.
Se SAP HANA è in esecuzione su un server Bare Metal Solution, lascia sempre Per impostazione predefinita, l'agente utilizza l'ID istanza della VM su cui è installato. |
zone |
String |
Quando SAP HANA è in esecuzione su una VM di Compute Engine in una zona diversa rispetto all'agente, specifica la zona della VM host SAP HANA. In Monitoring, questo valore è un'etichetta della risorsa che puoi utilizzare per filtrare i dati.
Se SAP HANA è in esecuzione su un server Bare Metal Solution, lascia sempre Per impostazione predefinita, l'agente utilizza la zona della VM su cui è installato. |
gcloud_auth |
Proprietà correlate all'account di servizio che l'agente utilizza per la gestione di identità e accessi. | |
service_account_json |
String | Specifica il percorso di un file JSON contenente la chiave di un account di servizio personalizzato che crei. Google Cloud utilizza
l'account di servizio per autenticare l'agente e determinare
le API e le risorse Google Cloud a cui 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 (inclusi) e incollandole subito dopo il primo set. Definisci il database
aggiuntivo con il nuovo insieme di proprietà.
|
|
- name |
String |
Il nome dell'host su cui è in esecuzione SAP HANA. Questo valore identifica l'istanza SAP HANA. In Monitoring, questo valore è l'etichetta della metrica che puoi utilizzare per filtrare i dati. Se stai monitorando più di un database, modifica questo valore per distinguere i database. |
sid |
String | Una proprietà facoltativa che specifica il SID dell'istanza SAP HANA che l'agente sta monitorando.
Normalmente l'agente recupera questo valore da SAP HANA automaticamente,
quindi non è necessario specificarlo. Se devi specificare un valore diverso oppure l'agente non rileva automaticamente il SID, rimuovi il commento dalla proprietà |
host |
String | L'indirizzo IP dell'host SAP HANA. Se l'agente è in esecuzione sullo stesso host di SAP HANA, puoi accettare l'indirizzo IP 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 unico database tenant, specifica 3nn15,
dove nn è il numero di istanza SAP HANA. Per ulteriori informazioni sulle porte SAP HANA, consulta la pagina relativa alle 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 |
String | L'account utente del database SAP HANA utilizzato dall'agente per eseguire le query su SAP HANA.
SYSTEM è l'impostazione predefinita.
|
password |
String | La password per l'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 |
String | Se utilizzi Secret Manager per archiviare le credenziali utente del database, specifica il nome del secret che contiene le credenziali di sicurezza. |
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 Monitoring per SAP HANA utilizza JVM predefinita.
Se l'archivio chiavi è protetto da password, è necessario specificare |
|
key_store_password |
Quando un archivio chiavi è protetto da password, specifica una password in testo normale per l'archivio chiavi.
La specifica di key_store_password si esclude a vicenda
e 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 che contiene la password
per l'archivio chiavi.
La specifica di key_store_secret_name si esclude a vicenda
e la specifica di key_store_password.
|
|
trust_store |
Specifica il percorso del file JKS del truststore che contiene i certificati pubblici del server SAP HANA. In genere, l'archivio di 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 il truststore predefinito della JVM. | |
trust_store_password |
Quando un archivio attendibilità è protetto da password, specifica una password in testo normale per l'archivio di attendibilità.
La specifica di trust_store_password si esclude a vicenda
e 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 che contiene la password
per l'archivio di attendibilità.
La specifica di trust_store_secret_name si esclude a vicenda
e la specifica di trust_store_password.
|
|
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 si riavvii ogni volta che viene riavviata l'istanza VM.
Per abilitare l'agente:
Stabilisci una connessione SSH con la VM host.
Esegui il comando seguente:
sudo systemctl enable google-saphanamonitoring-agent
Dovresti vedere un output simile all'esempio seguente:
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 comando seguente:
sudo systemctl start google-saphanamonitoring-agent
Controlla lo stato dell'agente:
sudo systemctl status google-saphanamonitoring-agent
Se l'avvio va a buon fine, dopo qualche secondo 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:
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 su 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
Se aggiungi una query personalizzata o modifichi la configurazione dell'agente, devi arrestare e avviare l'agente prima che la nuova query o altre modifiche alla configurazione vengano applicate.
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:
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.jsondi 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 visualizzare la dashboard, segui le istruzioni in Visualizzare la dashboard installata.
Per ulteriori informazioni, vedi:
Visualizzazione della dashboard installata
Il file performance.json nel repository crea una nuova dashboard personalizzata
con il titolo "SAP HANA Performance".
Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Nel pannello di navigazione di Monitoring, fai clic su Dashboard.
Fai clic su SAP HANA Performance (Prestazioni SAP HANA) nell'elenco. Se hai molte dashboard, puoi applicare un filtro in base alle dashboard personalizzate o al nome della nuova dashboard. Per informazioni su come filtrare questo elenco, consulta Visualizzazione delle dashboard personalizzate.
L'acquisizione di schermata seguente mostra parte della dashboard personalizzata per SAP HANA in Monitoring.
Aggiornamento dell'agente Monitoring per SAP HANA
Per assicurarti di avere la versione più recente dell'agente Monitoring per SAP HANA, verifica periodicamente se sono disponibili aggiornamenti. Gli aggiornamenti vengono annunciati nella pagina delle note di rilascio di SAP su Google Cloud.
Verifica aggiornamenti in corso...
Seleziona il tuo sistema operativo:
RHEL
Stabilisci una connessione SSH con la VM host.
Esegui il comando seguente:
sudo yum check-update google-saphanamonitoring-agent
SLES
Stabilisci una connessione SSH con la VM host.
Esegui il comando seguente:
sudo zypper list-updates -r google-saphanamonitoring-agent
Installazione di un aggiornamento
Seleziona il tuo sistema operativo:
RHEL
Stabilisci una connessione SSH con la VM host.
Esegui il comando seguente:
sudo yum update google-saphanamonitoring-agent
SLES
Stabilisci una connessione SSH con la VM host.
Esegui il comando seguente:
sudo zypper --no-gpg-checks update google-saphanamonitoring-agent
Risoluzione dei problemi
Le sezioni seguenti forniscono i passaggi 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 maggiori informazioni, vedi Sistemi operativi supportati.
Verifica la presenza nella shell dei messaggi di errore utilizzati per installare l'agente.
Verifica che il repository RPM di Google Cloud per l'agente sia stato aggiunto all'elenco di repository del sistema operativo, come descritto in Aggiungere il repository RPM di Google Cloud all'elenco di repository del sistema operativo.
Le query predefinite hanno esito negativo
Sulla VM host, verifica la presenza di messaggi di errore nel file di log /var/log/google-saphanamonitoring-agent.log.
Sulla 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 sulle porte da utilizzare per le query SAP HANA SQL, consulta Porte TCP/IP di tutti i prodotti SAP.
Assicurati che l'utente del tuo database SAP HANA abbia accesso alle seguenti viste di sistema SAP HANA:
M_CONNECTIONSM_CS_ALL_COLUMNSM_CS_TABLESM_HOST_RESOURCE_UTILIZATIONM_RS_TABLESM_SERVICE_COMPONENT_MEMORYM_SERVICE_MEMORYM_SERVICE_REPLICATIONM_WORKLOADSTATISTICS_CURRENT_ALERTSvisualizzazione dello schema_SYS_STATISTICS
Le metriche non vengono inviate a Monitoring
Sulla VM host, verifica la presenza di 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 di IAM e amministrazione, assicurati che l'account di servizio utilizzato dall'agente abbia il ruolo Monitoring Metric Writer (roles/monitoring.metricWriter). Per saperne di più, consulta Impostazione dei ruoli IAM richiesti.
Richiesta di assistenza per l'agente Monitoring per SAP HANA
Se hai bisogno di aiuto per risolvere un problema con l'agente di monitoraggio per SAP HANA, raccogli le informazioni diagnostiche necessarie e contatta l'assistenza clienti Google Cloud. Per ulteriori informazioni, consulta Informazioni diagnostiche dell'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 della console Google Cloud. Se l'assistenza clienti determina che un problema si verifica nei tuoi sistemi SAP, viene indirizzato al supporto SAP.
Per problemi relativi ai prodotti SAP, registra la richiesta di assistenza con
l'assistenza SAP.
SAP valuta il ticket di assistenza e, se risulta che si tratti di un problema di infrastruttura Google Cloud, SAP trasferisce il ticket al componente Google Cloud appropriato nel suo sistema: BC-OP-LNX-GOOGLE o BC-OP-NT-GOOGLE.
Requisiti di assistenza
Prima di poter ricevere assistenza per sistemi SAP e 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:
- Ricevi assistenza per SAP su Google Cloud
- SAP Note 2456406 - SAP on Google Cloud Platform: Support Prerequisiti (È richiesto un account utente SAP)