En esta página se describe cómo usar Service Infrastructure para habilitar servicios administrados a fin de enviar registros a los proyectos del productor de servicios y del consumidor de servicios.
La API de control de servicios acepta datos de registro estructurados o no estructurados, que agrupa en lotes y reenvía a Cloud Logging. Tanto tú como los usuarios de tus servicios administrados pueden usar la consola de Google Cloud y la Consola de API de Google para ver los datos de registro, o usar la API de Cloud Logging para acceder a los datos de manera programática.
Mientras que Logging por sí solo permite que un servicio administrado genere registros para que los utilices como desarrollador del servicio administrado, la API de Control de servicios también te permite generar registros que están destinados a tus usuarios. Esto permite que los usuarios entiendan y diagnostiquen el uso de tu servicio administrado.
Configura registros
Antes de enviar registros a la API de Control de servicios, debes especificar tres bits diferentes de información en la configuración de servicio:
Nombres de registro: Puedes tener uno o más registros distintos. Cada registro se identifica mediante un nombre único. Los registros individuales te permiten aislar tipos distintos de datos si esto facilita la visualización o el uso de los datos.
Recursos supervisados: Un recurso supervisado representa una entidad de la nube que produce algunos datos de registro. Para definir un recurso supervisado en la configuración del servicio, consulta monitored_resource.proto para ver la especificación técnica. Te recomendamos que uses el mismo recurso supervisado para la supervisión y el registro.
Configuración de registro: Te permite especificar el recurso supervisado asociado con cualquier transmisión de registro y el proyecto del productor de servicios o el consumidor de servicios donde se debe enviar cada registro. Para configurar la asociación de registros, consulta logging.proto a fin de ver la especificación técnica.
En el siguiente ejemplo de configuración de servicio, el registro activity_log está configurado para enviarse al consumidor de servicios.
# The definition of the monitored resource to be used.
monitored_resources:
- type: library.appspot.com/Branch
description: A library branch
display_name: Library Branch
launch_stage: ALPHA
labels:
- key: resource_container
description: The Google Cloud resource container (ie. project id) for
the branch.
- key: location
description: The Google Cloud region the branch is located.
- key: branch_id
description: The ID of the branch.
# The log name to be used.
logs:
- name: activity_log
# The logging configuration.
logging:
consumer_destinations:
- monitored_resource: library.appspot.com/Branch
logs:
- activity_log
Una vez que hayas creado esa configuración, deberás seguir las instrucciones sobre cómo administrar configuraciones de servicio y administrar lanzamientos de servicios para enviar la configuración del servicio a la API de Administración de Servicios , que configurará el recurso supervisado en Cloud Logging.
Informa registros
Una vez que finaliza el envío de la configuración de servicio, puedes llamar a la API de Control de servicios para informar las entradas de registro. El siguiente ejemplo utiliza el comando de gcurl para demostrar la llamada. Para obtener información sobre cómo realizar la configuración, consulta Comienza a usar la API de Control de servicios.
gcurl -d "{
'operations': [ {
'operationId': 'e8bf36ef-f9b5-4274-b4f9-079a3731e6e5',
'operationName': 'New book arrived',
'consumerId': 'projects/library-consumer',
'startTime': '`date +%FT%T%:z`',
'endTime': '`date +%FT%T%:z`',
'labels': {
'location': 'us-east1',
'branch_id': 'my-test-library-branch'
},
'logEntries': [ {
'severity': 'INFO',
'textPayload': 'new book arrived',
'name': 'activity_log'
} ]
} ]
}" https://servicecontrol.googleapis.com/v1/services/endpointsapis.appspot.com:report