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:
No console do Google Cloud, acesse Stackdriver > Geração de registros página:
Selecione a API produzida,
SERVICE_NAME
, ondeSERVICE_NAME
é o nome do serviço do Endpoints.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. |