Utilizzare i log della piattaforma

Questa pagina descrive come visualizzare i log della piattaforma generati da Runtime SaaS. I log della piattaforma in Google Cloud sono log specifici del servizio, che puoi utilizzare per eseguire il debug e risolvere i problemi e comprendere meglio i servizi che utilizzi. Google Cloud

Per informazioni dettagliate sui log della piattaforma Runtime SaaS supportati, consulta Log della piattaformaGoogle Cloud . Per ulteriori informazioni su come interpretare i dati nelle tabelle dei log della piattaforma, consulta Struttura delle voci di log.

Prima di iniziare

  1. Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .
  2. Assicurati che la fatturazione sia abilitata per il tuo progetto Google Cloud .
  3. Abilita l'API SaaS Runtime.
  4. Per ottenere le autorizzazioni necessarie per visualizzare i log e creare avvisi, chiedi all'amministratore di concederti i seguenti ruoli Identity and Access Management (IAM) nel progetto:
    • Visualizzatore log (roles/logging.viewer)
    • Editor Monitoring (roles/monitoring.editor)

Crea avvisi basati su log

Per creare un avviso basato su log, devi creare una query in Esplora log che restituisca le voci di log per le quali vuoi ricevere avvisi, quindi devi configurare il criterio di avviso.

  1. Nella console Google Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Nell'editor di query, inserisci una query per filtrare le voci di log scelte. Per query di esempio, consulta le sezioni seguenti.

  3. Fai clic su Crea avviso.

  4. Inserisci un nome e una descrizione per il criterio di avviso.

  5. Configura i dettagli dell'avviso, inclusi i canali di notifica.

  6. Fai clic su Salva avviso.

Per istruzioni dettagliate, vedi Creare un avviso basato su log.

Esempi di query per i log della piattaforma

Questa sezione fornisce query di esempio per scenari di avviso comuni basati sui log della piattaforma SaaS Runtime.

Avvisi relativi alle operazioni SaaS

Per creare un avviso quando un'operazione di provisioning di unità non va a buon fine, utilizza la query:

protoPayload.methodName="google.cloud.saasplatform.saasservicemgmt.v1beta1.SaasDeployments.CreateUnitOperation"
protoPayload.response.state="UNIT_OPERATION_STATE_FAILED"

Per creare un avviso quando un'operazione di provisioning di unità raggiunge uno stato terminale (riuscita, errore o annullamento), utilizza la query:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.UnitOperationLog"
AND (jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_SUCCEEDED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_FAILED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_CANCELLED")
AND jsonPayload.unit_operation_type="PROVISION"

Avvisi di implementazione

Per creare un avviso se un lancio regionale entra nello stato PAUSED o FAILED per un motivo diverso da un'azione dell'utente, utilizza la query:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.reason!="USER_PAUSE"
AND jsonPayload.root_rollout_id != resource.labels.rollout_id

Per creare un avviso se un rollout globale entra nello stato PAUSED o FAILED, utilizza la query:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.root_rollout_id == resource.labels.rollout_id

Per creare un avviso di log per quando un rollout entra nello stato PAUSED (perché SaaS Runtime ha identificato il rollout come non integro) o nello stato FAILED, utilizza la query:

logName:"rollout_events" 
(jsonPayload.currentState="PAUSED" jsonPayload.reason="SYSTEM_PAUSE")
OR 
jsonPayload.currentState="FAILED

Per creare un avviso di log per le metriche dello stato di implementazione quando un'implementazione entra in uno stato PAUSED (perché SaaS Runtime ha identificato l'implementazione come non integra) o in uno stato FAILED, utilizza la query:

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

Passaggi successivi