Nesta página, descrevemos como usar os registros de plataforma gerados pela IA antilavagem de dinheiro
como parte do Cloud Logging. A IA antilavagem de dinheiro usa o Logging
Nome do serviço de API financialservices.googleapis.com
para registrar a atividade de:
- Criação de configuração do mecanismo (ajuste)
- Criação de modelos (treinamento)
- Operações de backtest
- Operações de Prediction
Antes de começar
Para acessar e gerenciar os registros, verifique se você Permissões e papéis do IAM.
Status de ativação da geração de registros da plataforma
Os registros da plataforma da IA antilavagem de dinheiro estão sempre ativos (não podem ser ativados
Gravidade do registro
As entradas de registro da IA antilavagem de dinheiro usam três níveis de gravidade:
NOTICE
para entradas enviadas quando as operações são iniciadas ou concluídasERROR
para entradas sobre o fim das operações com falhaINFO
para entradas sobre o progresso da operação
Ver registros da plataforma
Para conferir os registros da plataforma, siga as instruções abaixo:
Console
Para conferir os registros da plataforma no console do Google Cloud:
Acesse o Explorador de registros:
Selecione o projeto do Google Cloud apropriado.
No campo Consulta, digite o seguinte comando de consulta:
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")
em que:
PROJECT_ID
é o ID do projeto que você quer depurar ou monitorar. Por exemplo,my-project
.Clique em Executar consulta.
Para mais informações sobre o Explorador de registros, consulte Visão geral do Explorador de registros e Como usar o Explorador de registros.
gcloud
A ferramenta de linha de comando gcloud fornece uma interface de linha de comando para o Cloud Logging.
Para ver os registros do seu projeto, execute o seguinte 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
em que PROJECT_ID
é o ID do projeto do Google Cloud.
Para mais informações sobre como usar a ferramenta gcloud com o Cloud Logging, consulte
gcloud logging
Entender os registros de plataforma
Esta seção descreve como entender registros específicos da plataforma para a IA de AML.
Registro START
Os registros com eventKind=START
são gerados quando a operação inicia a execução.
Veja a seguir um exemplo de registro de início de uma execução de previsão.
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
É possível adicionar outros comandos no campo Consulta da Análise de registros para restringir os registros exibidos.
Adicione o seguinte comando para exibir todas as execuções de previsão iniciadas em um conjunto de dados selecionado:
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"
Registro de PROGRESS
Os registros com eventKind=PROGRESS
informam sobre o progresso de uma operação.
Confira a seguir um exemplo de registro de criação de um modelo. completedTaskCount
x taskCount
pode ser usada para estimar o progresso do treinamento de modelo.
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'
FIM do registro
Os registros com eventKind=END
são produzidos quando a operação termina.
Veja a seguir um exemplo de registro de falha na criação de configuração do mecanismo. Ele contém o erro sobre dados incorretos no conjunto de dados fornecido.
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'
Para conferir todos os registros de erro de configuração do mecanismo de criação, use o filtro abaixo:
logName="projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" AND severity>=ERROR