Logging delle attività

Questo documento descrive come utilizzare Cloud Logging per il logging delle attività con Identity Platform.

Attivazione del logging delle attività in corso...

Il logging delle attività è disattivato per impostazione predefinita. Puoi abilitare il logging delle attività tramite la console Google Cloud o l'API REST:

Console

  1. Vai alla pagina Impostazioni nella console Google Cloud.
    Vai alle Impostazioni

  2. In Logging dell'attività utente, seleziona Attiva.

  3. Fai clic su Salva.

REST 

curl -d "{'monitoring':{'requestLogging':{'enabled':true}}}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -X PATCH -H 'Content-Type: application/json' \
  https://identitytoolkit.googleapis.com/admin/v2/projects/PROJECT_ID/config?updateMask=monitoring.requestLogging.enabled

Sostituisci PROJECT_ID con l'ID progetto.

L'attivazione del logging delle attività può influire sulla fatturazione. Per saperne di più, consulta i prezzi di Google Cloud Observability.

Abilitazione del logging delle attività per i progetti tenant

Il logging delle attività per i progetti tenant è disabilitato per impostazione predefinita. Puoi abilitare il logging delle attività per i progetti tenant utilizzando l'API REST eseguendo questo comando:

curl -d "{'monitoring':{'requestLogging':{'enabled':true}}}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -X PATCH -H 'Content-Type: application/json' \
  https://identitytoolkit.googleapis.com/v2/projects/PROJECT_ID/tenants/TENANT_ID?updateMask=monitoring.requestLogging.enabled

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • TENANT_ID: l'ID tenant.

L'attivazione del logging delle attività può influire sulla fatturazione. Per saperne di più, consulta Prezzi per l'osservabilità di Google Cloud.

Visualizzazione dei log delle attività

Se Logging è abilitato, viene generata una voce di log per ogni richiesta dell'utente. Ogni voce di log include i seguenti campi:

Campo Descrizione
logName projects/PROJECT_ID/logs/identitytoolkit.googleapis.com/requests
resource identitytoolkit_project or identitytoolkit_tenant
serviceName identitytoolkit.googleapis.com
protoPayload La richiesta o la risposta registrata.

Puoi visualizzare i log delle attività del progetto o del tenant utilizzando Esplora log. Per visualizzare i log:

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

    Vai alla pagina Esplora log

  2. Seleziona Progetto Identity Toolkit o Identity Toolkit Tenant dal menu a discesa delle risorse. Se utilizzi l'architettura multi-tenancy, puoi mostrare tutti i tenant o filtrare in base a un criterio specifico.

Operazioni registrate

Nella tabella seguente sono elencate le operazioni API che possono produrre log delle attività:

Servizio Metodo
google.cloud.identitytoolkit.v1.AccountManagementService DeleteAccount
GetAccountInfo
GetOobCode
ResetPassword
SetAccountInfo
google.cloud.identitytoolkit.v1.AuthenticationService CreateAuthUri
GetRecaptchaParam
SendVerificationCode
SignInWithCustomToken
SignInWithEmailLink
SignInWithGameCenter
SignInWithIdp
SignInWithPassword
SignInWithPhoneNumber
SignUp
VerifyIosClient
google.cloud.identitytoolkit.v1.ProjectConfigService GetProjectConfig

Esclusione delle operazioni

Logging offre gli strumenti per disabilitare l'importazione dei log o escludere le voci di log non desiderate. Per ulteriori informazioni su come escludere determinati log, consulta Esclusioni dei log.

L'esempio seguente mostra come escludere i log per i metodi di sola lettura GetAccountInfo() e GetProjectConfig():

resource.type="identitytoolkit_project"
(
 jsonPayload.methodName="google.cloud.identitytoolkit.v1.AccountManagementService.GetAccountInfo"
 OR
 jsonPayload.methodName="google.cloud.identitytoolkit.v1.ProjectConfigService.GetProjectConfig"
)