Usa registros de plataforma

En esta página, se describe cómo usar los registros de plataforma generados por la IA contra lavado de dinero 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 los registros, asegúrate de tener Permisos y roles de IAM.

Estado de activación del registro de la plataforma

Los registros de la plataforma para la IA de la AML siempre están activos (no se pueden apagar).

Gravedad del registro

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

  • NOTICE para las entradas que se envían cuando las operaciones comienzan o se realizan 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 la plataforma, sigue las instrucciones que aparecen a continuación:

Console

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

  1. Navega al Explorador de registros:

    Ir al Explorador de registros.

  2. Selecciona el proyecto de Google Cloud adecuado.

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

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

Comprende los registros de plataforma

En esta sección, se describe cómo comprender los registros específicos de la plataforma para la IA de AML.

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 de 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 predicción 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 la creación de una configuración del motor con errores. Contiene el error sobre los 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 configuración del motor de creación, usa el siguiente filtro:

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