Usar registros da plataforma

Nesta página, descrevemos como usar os registros de plataforma gerados pela IA de AML como parte do Cloud Logging. A IA de AML usa o nome do serviço da API de registro 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 conferir e gerenciar registros, verifique se você tem as permissões e papéis do IAM corretas.

Status de ativação da geração de registros da plataforma

Os registros da plataforma para IA de AML estão sempre ativos (não podem ser desativados).

Gravidade do registro

As entradas de registro da IA de AML usam três níveis de gravidade:

  • NOTICE para entradas enviadas quando as operações começam ou são bem-sucedidas
  • ERROR para entradas sobre o fim de operações com falha
  • INFO para entradas sobre o progresso da operação

Conferir os 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:

  1. Acesse o Explorador de registros:

    Acesse o Explorador de registros

  2. Selecione o projeto do Google Cloud apropriado.

  3. 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.

  4. 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 conferir 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 da 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 começa a ser executada.

Confira 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 do Logs Explorer para restringir os registros exibidos.

Adicione o comando a seguir para mostrar 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 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. A completedTaskCount em comparação com a taskCount pode ser usada para estimar o progresso feito no 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.

Confira a seguir um exemplo de registro de uma criação de configuração do mecanismo com falha. 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 motor de criação, use o filtro abaixo:

logName="projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" AND
severity>=ERROR