En esta página, se describe cómo usar los registros de plataforma que genera la IA contra lavado de dinero como parte de Cloud Logging. La IA contra el lavado de dinero usa el nombre de servicio de la API de Logging financialservices.googleapis.com
para registrar la actividad de los siguientes elementos:
- Creación de configuraciones de 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 permisos y funciones de IAM correctos.
Estado de activación del registro de la plataforma
Los registros de la plataforma de la IA contra lavado de dinero siempre están activos (no se pueden desactivar).
Gravedad del registro
Las entradas de registro de la IA contra el lavado de dinero usan tres niveles de gravedad:
NOTICE
para las entradas que se envían cuando las operaciones comienzan o se completan de forma correctaERROR
para las entradas relacionadas con el final de las operaciones fallidasINFO
para entradas sobre el progreso de la operación
Ver registros de plataforma
Para ver los registros de la plataforma, sigue estas instrucciones:
Console
Para ver los registros de plataforma en la consola de Google Cloud, sigue estos pasos:
Navega 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 Usa 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 ejemplo anterior, 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 plataforma
En esta sección, se describe cómo comprender los registros de plataforma específicos de la IA contra el lavado de dinero.
Registro de START
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 restringir 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
frente a taskCount
se puede usar para estimar el progreso que se realizó en el 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'
Registro END
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 de motor con errores. 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 creación de la configuración de motores, usa el siguiente filtro:
logName="projects/PROJECT_ID/logs/financialservices.googleapis.com%2Fengine_config_creation" AND severity>=ERROR