Usar registros de la plataforma

En esta página se describe cómo usar los registros de plataforma generados por la IA de AML como parte de Cloud Logging. La IA de AML usa el nombre de servicio de la API Logging financialservices.googleapis.com para registrar la actividad de lo siguiente:

  • Creación de configuraciones de motor (puesta a punto)
  • Creación de modelos (entrenamiento)
  • Operaciones de prueba retrospectiva
  • Operaciones de predicción

Antes de empezar

Para ver y gestionar los registros, asegúrate de tener los permisos y roles de gestión de identidades y accesos correctos.

Estado de activación del registro de la plataforma

Los registros de la plataforma de AML AI están siempre activos (no se pueden desactivar).

Gravedad del registro

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

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

Ver registros de la plataforma

Para ver los registros de la plataforma, sigue estas instrucciones:

Consola

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

  1. Ve al explorador de registros:

    Ir al Explorador de registros

  2. Selecciona el Google Cloud proyecto adecuado.

  3. En el campo Consulta, introduce 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 quieres depurar o monitorizar. Por ejemplo, my-project.

  4. Haz clic en Realizar una consulta.

Para obtener más información sobre el Explorador de registros, consulta los artículos Descripción general del Explorador de registros y Usar el Explorador de registros.

gcloud

La herramienta de línea de comandos gcloud proporciona una interfaz de línea de comandos a 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

donde PROJECT_ID es el ID de tu Google Cloud proyecto.

Para obtener más información sobre cómo usar la herramienta gcloud con Cloud Logging, consulta gcloud logging.

Interpretar los registros de la plataforma

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

START log

Los registros con eventKind=START se generan cuando la operación empieza a ejecutarse.

A continuación, se muestra 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 añadir comandos adicionales en el campo Consulta del explorador de registros para acotar los registros que se muestran.

Añade 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.

A continuación, se muestra un ejemplo de un registro de creación de un modelo. La completedTaskCount frente a la taskCount se puede usar para estimar el progreso que se ha hecho en el entrenamiento del 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'

END log

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

A continuación, se muestra un ejemplo de un registro de una creación de configuración de buscador fallida. Contiene el error sobre los datos incorrectos del 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 de creación de buscador, usa el filtro que aparece a continuación:

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