Esta página foi traduzida pela API Cloud Translation.

Use registos da plataforma

Esta página descreve como usar os registos da plataforma gerados pela IA da AML como parte do Cloud Logging. A IA da AML usa o nome do serviço da API Logging financialservices.googleapis.com para registar a atividade de:

Criação da configuração do motor (afinação)
Criação de modelos (preparação)
Operações de teste retrospetivo
Operações de previsão

Antes de começar

Para ver e gerir registos, certifique-se de que tem as autorizações e funções de IAM corretas.

Estado da ativação dos registos de plataformas

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

Gravidade do registo

As entradas de registo 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 das operações com falhas
INFO para entradas sobre o progresso da operação

Veja os registos da plataforma

Para ver os registos da plataforma, siga as instruções abaixo:

Consola

Para ver os registos da plataforma na Google Cloud consola:

Navegue para o Explorador de registos:

Aceda ao Explorador de registos
Selecione o Google Cloud projeto adequado.

No campo Consulta, introduza 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")

where:

PROJECT_ID é o ID do projeto que quer depurar ou monitorizar. Por exemplo, my-project.

Clique em Executar consulta.

Para mais informações sobre o Explorador de registos, consulte os artigos Vista geral do Explorador de registos e Usar o Explorador de registos.

gcloud

A ferramenta de linhas de comando gcloud fornece uma interface de linhas de comando para o Cloud Logging.

Para ver os registos 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 seu projeto Google Cloud .

Para mais informações sobre a utilização da ferramenta gcloud com o Cloud Logging, consulte o artigo gcloud logging.

Compreenda os registos da plataforma

Esta secção descreve como compreender registos de plataformas específicas para a IA de AML.

Registo START

Os registos com eventKind=START são gerados quando a operação inicia a respetiva execução.

Segue-se um exemplo de um registo 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

Pode adicionar comandos adicionais no campo Consulta do Explorador de registos para restringir os registos apresentados.

Adicione o seguinte comando para apresentar todas as execuções de previsão iniciadas num 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"

Registo PROGRESS

Os registos com eventKind=PROGRESS informam sobre o progresso de uma operação.

Segue-se um exemplo de um registo de criação de um modelo. Pode usar a comparação entre completedTaskCount e taskCount para estimar o progresso realizado na preparação do 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'

Registo END

Os registos com eventKind=END são produzidos quando a operação termina.

Segue-se um exemplo de um registo de uma criação de configuração do motor com falha. 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 ver todos os registos de erros de configuração do motor, use o filtro abaixo:

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