Esta página descreve como usar a infraestrutura de serviços para permitir que os serviços geridos enviem registos para projetos de produtor de serviços e consumidor de serviços.
A API Service Control aceita dados de registo estruturados ou não estruturados, que agrupa e encaminha para o Cloud Logging. Tanto o administrador como os utilizadores dos seus serviços geridos podem usar aGoogle Cloud consola e a API Console (Google) para ver os dados de registo ou usar a API Cloud Logging para aceder aos dados de forma programática.
Enquanto o registo em si permite que um serviço gerido gere registos para utilização por si como programador do serviço gerido, a API Service Control também lhe permite gerar registos destinados aos seus utilizadores. Isto permite que os seus utilizadores compreendam e diagnostiquem a respetiva utilização do seu serviço gerido.
Configurar registos
Antes de enviar registos para a API Service Control, tem de especificar três informações diferentes na sua configuração do serviço:
Nomes dos registos: pode ter um ou mais registos distintos. Cada registo é identificado por um nome exclusivo. Os registos individuais permitem isolar tipos distintos de dados se isso facilitar a visualização ou a utilização dos dados.
Recursos monitorizados: Um recurso monitorizado representa uma entidade na nuvem que produz alguns dados de registo. Para definir um recurso monitorizado na configuração do serviço, consulte o ficheiro monitored_resource.proto para ver a especificação técnica. Recomendamos vivamente que use o mesmo recurso monitorizado para a monitorização e o registo.
Configuração de registos: permite especificar o recurso monitorizado associado a qualquer fluxo de registos e o projeto de produtor de serviços ou consumidor de serviços para onde cada registo deve ser enviado. Para configurar a associação de registos, consulte o ficheiro logging.proto para ver a especificação técnica.
No exemplo seguinte de configuração do serviço, o registo activity_log está configurado para ser enviado para o consumidor do serviço.
# 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
Depois de criar essa configuração, tem de seguir os passos em Gerir configurações de serviços e Gerir implementações de serviços para enviar a configuração de serviços para a API Service Management, que vai configurar o recurso monitorizado no Cloud Logging.
Registos de relatórios
Depois de a transmissão da configuração do serviço terminar, pode chamar a API Service Control para comunicar entradas de registo. O exemplo seguinte usa o comando gcurl para demonstrar a chamada. Para saber como configurar esta opção, consulte o artigo
Introdução à API Service Control.
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