Registos de pontos finais

Quando os utilizadores fazem pedidos à sua API, o proxy de serviço extensível (ESP) usa o Cloud Logging para registar informações sobre os pedidos e as respostas. Esta página descreve as informações registadas.

Para localizar os registos do Cloud Endpoints na página Explorador de registos:

1. Na Google Cloud consola, aceda à página Operações > Registo:

   Aceda à página do Explorador de registos

2. Selecione API produzida, SERVICE_NAME, onde SERVICE_NAME é o nome do serviço Endpoints.

   Nota: só pode selecionar API produzida no menu de recursos se uma mensagem de registo recente contiver o tipo de recurso API.

3. Clique no registo que quer investigar. O registo contém uma mensagem JSON estruturada, como a seguinte:

   {
     insertId: "…"
     jsonPayload: {…}
     resource: {
       type: "api"
       labels: {…}
     }
     timestamp: "2017-05-08T15:00:02.804424422Z"
     severity: "INFO"
     logName: "…"
   }
   

O objeto jsonPayload contém todas as informações comunicadas pelo ESP. A tabela seguinte descreve os respetivos campos:

Campo	Descrição
url	Caminho de URL do pedido.
producer_project_id	Google Cloud ID do projeto proprietário da API.
api_name	Nome da API invocada.
api_version	Versão da API com nome invocada.
api_method	Método da API com nome invocado.
api_key	Chave da API usada pelo consumidor de chamadas, se presente.
http_method	Método HTTP do pedido, como GET e POST.
request_size_in_bytes	Tamanho do corpo do pedido em bytes.
http_response_code	Código de estado HTTP da resposta, como 200, 404 e 500.
response_size_in_bytes	Tamanho do corpo da resposta em bytes.
request_latency_in_ms	Tempo que demorou a responder ao pedido em milissegundos, incluindo o tempo que o ESP e o respetivo back-end demoraram. Não está presente para métodos de streaming.
timestamp	Data/hora em que o pedido foi recebido.
location	Google Cloud zona que processou o pedido.
log_message	Mensagem curta sobre o método chamado e o respetivo estado, se for rejeitado. Não são registados campos de informações da API para chamadas rejeitadas.
error_cause	Mensagem de erro se a resposta tiver sido um erro.
labels	A secção labels contém informações que identificam a origem do registo, como o Google Cloud ID do projeto, o nome do serviço Endpoints, o número da versão da API e o nome do método.

O que se segue?

• Monitorizar a sua API