Informazioni di diagnostica dell'agente per SAP di Google Cloud

Per i problemi relativi alla versione 3.8 (ultima) dell'agente diGoogle Cloudper SAP, fornisci al assistenza clienti Google Cloud le seguenti informazioni di diagnostica il prima possibile:

• Una descrizione completa e dettagliata del problema.
• Il bundle di assistenza per l'agente.
• I dati più recenti raccolti dall'agente.
• Il file di configurazione dell'agente.
• Il file di log dell'agente.

Descrizione dettagliata del problema

Fornisci una descrizione completa e dettagliata del problema, inclusa la versione dell'agente e la data e l'ora in cui si è verificato.

Per controllare la versione dell'agente:

Support Bundle

Il bundle di assistenza è una raccolta di informazioni dell'agente per SAP di Google Cloud, che aiuta l'assistenza clienti a fornirti assistenza per la risoluzione dei problemi. Questa funzionalità è disponibile per l'agente per SAP di Google Cloudversione 2.1 o successive.

Dalla versione 3.4 dell'agente, puoi caricare l'output del comando supportbundle utilizzando l'opzione result-bucket. Per farlo, devi assicurarti che l'account di servizio utilizzato dall'agente disponga della seguente autorizzazione IAM: storage.objects.create.

Che cosa contiene il pacchetto di assistenza

• I file di log e di configurazione dell'agente.

  A partire dalla versione 3.0 dell'agente, sono inclusi i log e i file di configurazione correlati alle funzionalità Backint e Istantanea disco dell'agente.

• File di traccia e topologia SAP HANA per l'hostname e l'SID specificati.

• File di configurazione e log dell'agente Backint di Cloud Storage per SAP HANA.

• Per un cluster ad alta disponibilità (HA) su RHEL, quando specifichi pacemaker-diagnosis="true", l'output di sosreport viene salvato nella seguente directory: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Se l'esecuzione del comando sosreport non riesce, l'output di crm_report viene salvato nella directory specificata.

• Per un cluster HA su SUSE, quando specifichi pacemaker-diagnosis=true, l'output delle utilità hb_report e supportconfig viene salvato nella seguente directory:/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Se l'esecuzione di queste utilità non va a buon fine, l'output di hb_report e crm_report viene salvato nella directory specificata.

• Il file /var/log/messages, che fornisce informazioni utili sulle operazioni di sistema Linux.

• Dalla versione 3.8 dell'agente, il file sapdiscovery.json è incluso per impostazione predefinita. Il file contiene informazioni sui prodotti SAP e sui componenti correlati in esecuzione nell'istanza di calcolo. Queste informazioni forniscono all'assistenza clienti un contesto migliore sul ruolo e sulla configurazione del sistema SAP.

  Per consentire all'agente di raccogliere queste informazioni, devi soddisfare i seguenti requisiti:

  • Specifica "log_to_cloud": true nel file di configurazione dell'agente.
  • Concedi l'autorizzazione IAM logging.logEntries.list all'account di servizio utilizzato dall'agente.

• Dalla versione 3.8 dell'agente, quando specifichi l'opzione metrics, il bundle include informazioni sulle occorrenze di eventi SAP predefiniti e sulle variazioni dei valori di Metrica di monitoraggio dei processi e Metrica di monitoraggio di SAP HANA per un periodo di tempo specifico.

  • Per consentire all'agente di raccogliere informazioni sulle occorrenze di eventi SAP predefiniti dai log di Cloud Logging, devi soddisfare i seguenti requisiti:
    • Specifica "log_to_cloud": true nel file di configurazione dell'agente.
    • Concedi l'autorizzazione IAM logging.logEntries.list all'account di servizio utilizzato dall'agente.
  • Per consentire all'agente di raccogliere informazioni sulle variazioni dei valori delle metriche da Cloud Monitoring, devi soddisfare i seguenti requisiti:
    • Specifica "send_metrics_to_monitoring": true nel file di configurazione dell'agente.
    • Concedi la seguente autorizzazione IAM all'account di servizio utilizzato dall'agente: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list e monitoring.timeSeries.list.
  • Il periodo di tempo con cui l'agente filtra i log di Cloud Logging e le voci di Cloud Monitoring è determinato dal comportamento delle seguenti opzioni:
    • timestamp: il timestamp, nel formato YYYY-MM-DD HH:MM:SS, intorno al quale vuoi raccogliere informazioni sulle occorrenze dei tipi di eventi SAP predefiniti e sulle variazioni dei valori delle metriche. Il valore predefinito è il momento in cui esegui il comando supportbundle.
    • before-duration: il numero di secondi prima di timestamp durante i quali l'agente cerca le occorrenze di eventi SAP predefiniti e le variazioni dei valori delle metriche. Il valore predefinito è 3600 secondi.
    • after-duration: il numero di secondi dopo timestamp durante i quali l'agente cerca le occorrenze di eventi SAP predefiniti e le variazioni dei valori delle metriche. Il valore predefinito è 1800 secondi.

  • Le informazioni raccolte sono organizzate in cartelle contenenti file JSON per ogni tipo di evento SAP che si è verificato e per ogni metrica che ha modificato il proprio valore. Di seguito è riportato un esempio di come viene visualizzato l'output:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Generare un bundle per l'assistenza

Per generare il bundle di assistenza per un'istanza dell'agente in esecuzione su Linux, esegui il seguente comando sull'istanza di calcolo:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Sostituisci quanto segue:

• SID: l'ID del tuo sistema SAP.
• INSTANCE_NUMBERS: i numeri delle istanze SAP per le quali vuoi generare il bundle di assistenza.

  Per specificare più numeri di istanze, separali con uno spazio. Ad esempio, 00 11 22. Quando specifichi due o più numeri di istanze SAP, il comando genera un bundle di assistenza combinato per le istanze specificate.

• HOST_NAME: il nome dell'host su cui esegui il comando.
• BOOLEAN_VALUE: il valore true o false, che determina se viene eseguita o meno la diagnosi relativa al pacemaker. Il valore predefinito è false.
• BUCKET_NAME: il nome del bucket Cloud Storage in cui vuoi caricare l'output del comando supportbundle.
• TIMESTAMP: il timestamp, nel formato YYYY-MM-DD HH:MM:SS, in base al quale vuoi raccogliere informazioni sulle occorrenze dei tipi di eventi SAP predefiniti e sulle modifiche ai valori delle metriche. Il valore predefinito è l'ora in cui esegui il comando supportbundle.
• BEFORE_DURATION: il numero di secondi prima del valore dell'opzione timestamp durante i quali l'agente cerca le occorrenze di eventi SAP predefiniti e le variazioni dei valori delle metriche. Il valore predefinito è 3600 secondi.
• AFTER_DURATION: il numero di secondi dopo il valore dell'opzione timestamp durante i quali l'agente cerca le occorrenze di eventi SAP predefiniti e le variazioni dei valori delle metriche. Il valore predefinito è 1800 secondi.

Dati più recenti raccolti dall'agente

Fornisci i dati più recenti raccolti dall'agente. Salva i dati più recenti raccolti dall'agente in un file e allegalo alla richiesta di assistenza.

Per visualizzare i dati più recenti raccolti dall'agente:

File di configurazione

Dopo aver rimosso le credenziali, ad esempio il nome utente e le password del database SAP HANA, fornisci il file di configurazione dell'agente per SAP di Google Cloud.

Per trovare il file di configurazione dell'agente, vai al seguente percorso:

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

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

File di log

Fornisci il file di log dell'agente per SAP di Google Cloud.

Per trovare il file di log dell'agente, vai al seguente percorso:

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log