Questa pagina descrive come utilizzare i log della piattaforma generati da AML AI nell'ambito di Cloud Logging. AML AI utilizza il nome del servizio dell'API Logging financialservices.googleapis.com
per registrare l'attività di:
- Creazione della configurazione del motore (ottimizzazione)
- Creazione di modelli (addestramento)
- Operazioni di backtest
- Operazioni di previsione
Prima di iniziare
Per visualizzare e gestire i log, assicurati di disporre delle autorizzazioni e dei ruoli IAM corretti.
Stato di attivazione del logging della piattaforma
I log della piattaforma per AML AI sono sempre attivi (non possono essere disattivati).
Gravità log
Le voci di log di AML AI utilizzano tre livelli di gravità:
NOTICE
per le voci inviate quando le operazioni iniziano o hanno esito positivoERROR
per le voci relative alla fine delle operazioni non riusciteINFO
per le voci sull'avanzamento dell'operazione
Visualizza i log della piattaforma
Per visualizzare i log della piattaforma, segui le istruzioni riportate di seguito:
Console
Per visualizzare i log della piattaforma nella console Google Cloud:
Vai a Esplora log:
Seleziona il progetto Google Cloud appropriato.
Nel campo Query, inserisci il seguente comando di query:
logName=("projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fbacktest" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fmodel_creation" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fprediction")
dove:
PROJECT_ID
è l'ID del progetto di cui vuoi eseguire il debug o monitorare. Ad esempio,my-project
.Fai clic su Esegui query.
Per ulteriori informazioni su Esplora log, consulta Panoramica di Esplora log e Utilizzo di Esplora log.
gcloud
Lo strumento a riga di comando gcloud fornisce un'interfaccia a riga di comando per Cloud Logging.
Per visualizzare i log del progetto, esegui questo comando:
gcloud logging read 'logName=("projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fbacktest" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fmodel_creation" OR "projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fprediction")' --project=PROJECT_ID
dove PROJECT_ID
è l'ID del tuo progetto Google Cloud.
Per ulteriori informazioni sull'utilizzo dello strumento gcloud con Cloud Logging, consulta
gcloud logging
.
Informazioni sui log della piattaforma
Questa sezione descrive come comprendere i log specifici della piattaforma per AML AI.
Diario di avvio
I log con eventKind=START
vengono generati all'avvio dell'esecuzione dell'operazione.
Di seguito è riportato un esempio di log di avvio dell'esecuzione di una previsione.
jsonPayload: '@type': type.googleapis.com/google.cloud.financialservices.logging.v1.PredictionLog engineVersion: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/engineVersions/ENGINE_VERSION_ID eventKind: START predictionResult: dataset: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/datasets/DATASET_ID endTime: '2023-05-31T00:00:00Z' model: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/models/MODEL_ID outputs: explainabilityDestination: tableUri: bq://PROJECT_ID.DATASET_ID.EXPLAINABILITY_TABLE_ID writeDisposition: WRITE_EMPTY predictionDestination: tableUri: bq://PROJECT_ID.DATASET_ID.PREDICTION_TABLE_ID writeDisposition: WRITE_EMPTY logName: projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fprediction operation: first: true id: projects/PROJECT_NUMBER/locations/REGION_ID/operations/OPERATION_ID producer: financialservices.googleapis.com receiveTimestamp: '2023-06-07T12:30:48.417285528Z' resource: labels: instance_id: INSTANCE_ID location: REGION_ID prediction_result_id: PREDICTION_ID resource_container: projects/PROJECT_NUMBER type: financialservices.googleapis.com/PredictionResult
Puoi aggiungere altri comandi nel campo Query di Esplora log per limitare il numero di log visualizzati.
Aggiungi il comando seguente per visualizzare tutte le esecuzioni di previsione avviate su un set di dati selezionato:
logName="projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fprediction" AND jsonPayload.predictionResult.dataset="projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/datasets/DATASET_ID" AND jsonPayload.eventKind="START"
Log PROGRESS
I log con eventKind=PROGRESS
indicano l'avanzamento di un'operazione.
Di seguito è riportato un esempio di log di creazione di un modello. completedTaskCount
e taskCount
possono essere utilizzati per stimare i progressi compiuti nell'addestramento del modello.
jsonPayload: '@type': type.googleapis.com/google.cloud.financialservices.logging.v1.ModelCreationLog completedTaskCount: 11 engineVersion: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/engineVersions/ENGINE_VERSION_ID eventKind: PROGRESS model: endTime: '2023-05-31T00:00:00Z' engineConfig: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/engineConfigs/ENGINE_CONFIG_ID engineVersion: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/engineVersions/ENGINE_VERSION_ID lineOfBusiness: RETAIL primaryDataset: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/datasets/DATASET_ID state: CREATING partyCount: '9246' taskCount: 16 logName: projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fmodel_creation operation: id: projects/PROJECT_NUMBER/locations/REGION_ID/operations/OPERATION_ID producer: financialservices.googleapis.com receiveTimestamp: '2023-06-07T13:57:00.454668648Z' resource: labels: instance_id: INSTANCE_ID location: REGION_ID model_id: MODEL_ID resource_container: projects/PROJECT_NUMBER type: financialservices.googleapis.com/Model severity: INFO timestamp: '2023-06-07T13:56:59.772973055Z'
Log END
I log con eventKind=END
vengono generati al termine dell'operazione.
Di seguito è riportato un esempio di log di una creazione di configurazione del motore non riuscita. Contiene l'errore relativo ai dati sbagliati nel set di dati fornito.
jsonPayload: '@type': type.googleapis.com/google.cloud.financialservices.logging.v1.EngineConfigCreationLog completedTaskCount: 3 engineConfig: engineVersion: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/engineVersions/ENGINE_VERSION_ID lineOfBusiness: RETAIL performanceTarget: partyInvestigationsPerPeriodHint: '100' state: CREATING tuning: endTime: '2019-04-30T00:00:00Z' primaryDataset: projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID/datasets/DATASET_ID eventKind: END operationStatus: code: 9 details: - '@type': type.googleapis.com/google.rpc.ErrorInfo domain: financialservices.googleapis.com metadata: count: '15' data_field: party_id, validity_start_time data_table: party description: There is a duplicate primary key value in the database resulting in unique key violation. Note that for tables with validity_start_time, the primary key includes validity_start_time test: GROUP BY party_id, validity_start_time HAVING count(1) > 1 reason: DUPLICATE_PRIMARY_KEY message: Dataset validation failed with 1 error. See error details for individual violations. partyCount: '9246' taskCount: 16 logName: projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation operation: id: projects/PROJECT_NUMBER/locations/REGION_ID/operations/OPERATION_ID last: true producer: financialservices.googleapis.com receiveTimestamp: '2023-06-07T14:26:30.214382295Z' resource: labels: engine_config_id: ENGINE_CONFIG_ID instance_id: INSTANCE_ID location: REGION_ID resource_container: projects/PROJECT_NUMBER type: financialservices.googleapis.com/EngineConfig severity: ERROR timestamp: '2023-06-07T14:26:29.670913895Z'
Per visualizzare tutti i log degli errori di creazione della configurazione del motore, utilizza il filtro seguente:
logName="projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" AND severity>=ERROR