Registros do Endpoints

Quando os usuários fazem solicitações à API, o Extensible Service Proxy (ESP) usa o Cloud Logging para registrar informações sobre as solicitações e respostas. Nesta página, são descritas as informações registradas.

Para localizar os registros do Cloud Endpoints na página Análise de registros:

  1. No console do Google Cloud, acesse a página Stackdriver > Logging:

    Acessar a página Explorador de registros

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

  3. Clique no registro que você quer visualizar. Ele contém uma mensagem JSON estruturada como esta:

    {
      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 relatadas pelo ESP. Esta tabela descreve os campos dele:

Campo Descrição
url Caminho do URL da solicitação.
producer_project_id ID do projeto do Google Cloud proprietário da API.
api_name Nome da API invocada
api_version Versão da API nomeada invocada.
api_method Método da API nomeada invocada.
api_key Chave de API usada pelo consumidor que fez a chamada, se houver.
http_method Método HTTP da solicitação, como GET e POST.
request_size_in_bytes Tamanho do corpo da solicitação em bytes.
http_response_code Código de status HTTP da resposta, como 200, 404 e 500.
response_size_in_bytes Tamanho do corpo da resposta em bytes.
request_latency_in_ms Tempo necessário para responder à solicitação em milissegundos, incluindo o tempo gasto pelo ESP e pelo back-end. Não presente para métodos de streaming.
timestamp Carimbo de data/hora de quando a solicitação foi recebida.
location Zona do Google Cloud que atendeu à solicitação.
log_message Mensagem curta sobre o método chamado e o status, se recusada. Nenhum campo de informações da API é registrado para chamadas recusadas.
error_cause Mensagem de erro, se a resposta foi um erro.
labels A seção labels contém informações que identificam a origem do registro, como o ID do projeto do Google Cloud, o nome do serviço do Endpoints, o número da versão da API e o nome do método.

A seguir