Se usó la API de Cloud Translation para traducir esta página.

Usa registros de plataforma

En esta página, se describe cómo usar los registros de plataforma que genera la IA de AML como parte de Cloud Logging. La IA contra el lavado de dinero usa Nombre del servicio de API financialservices.googleapis.com para registrar la actividad de:

Creación de la configuración del motor (ajuste)
Creación de modelos (entrenamiento)
Operaciones de backtest
Operaciones de predicción

Antes de comenzar

Para ver y administrar registros, asegúrate de tener los roles y permisos de IAM correctos.

Estado de activación del registro de la plataforma

Los registros de plataforma de la IA contra el lavado de dinero siempre están activos (no se pueden activar desactivadas).

Gravedad de los registros

Las entradas de registro de la IA de la AML usan tres niveles de gravedad:

NOTICE para las entradas enviadas cuando las operaciones se inician o se completan correctamente
ERROR para entradas sobre el final de las operaciones con errores
INFO para las entradas sobre el progreso de la operación

Ver registros de plataforma

Para ver los registros de plataforma, sigue las instrucciones a continuación:

Console

Para ver los registros de plataforma en la consola de Google Cloud, sigue estos pasos:

Navega al Explorador de registros:

Ir al Explorador de registros.
Selecciona el proyecto de Google Cloud adecuado.

En el campo Consulta, ingresa el siguiente 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")

Donde:

PROJECT_ID es el ID del proyecto que deseas depurar o supervisar. Por ejemplo, my-project

Haz clic en Ejecutar consulta.

Para obtener más información sobre el Explorador de registros, consulta Descripción general del Explorador de registros y Cómo usar el Explorador de registros.

gcloud

La herramienta de línea de comandos de gcloud proporciona una interfaz de línea de comandos para Cloud Logging.

Para ver los registros de tu proyecto, ejecuta el siguiente 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

en el que PROJECT_ID es el ID de tu proyecto de Google Cloud.

Para obtener más información sobre el uso de la herramienta de gcloud con Cloud Logging, consulta gcloud logging

Información sobre los registros de la plataforma

Esta sección describe cómo comprender los registros de plataforma específicos para IA contra lavado de dinero.

INICIAR registro

Los registros con eventKind=START se generan cuando la operación comienza su ejecución.

El siguiente es un ejemplo de un registro del inicio de una ejecución de predicción.

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

Puedes agregar comandos adicionales en el campo Consulta del Explorador de registros para acotar los registros que se muestran.

Agrega el siguiente comando para mostrar todas las ejecuciones de predicciones iniciadas en un conjunto de datos seleccionado:

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

Los registros con eventKind=PROGRESS informan sobre el progreso de una operación.

El siguiente es un ejemplo de un registro de la creación de un modelo. completedTaskCount vs. taskCount se puede usar para estimar el progreso del entrenamiento de modelos.

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'

END registro

Los registros con eventKind=END se producen cuando finaliza la operación.

El siguiente es un ejemplo de un registro de una creación de configuración de motor fallida. Contiene el error de datos incorrectos en el conjunto de datos proporcionado.

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 los registros de errores de la configuración de Create Engine, usa el siguiente filtro:

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