Nesta página, descrevemos os registros disponíveis ao usar o Cloud Run e como visualizá-los e gravá-los.
O Cloud Run tem três tipos de registros, que são enviados automaticamente para o Cloud Logging:
- Registros de solicitação (somente serviços): registros de solicitações enviadas para os serviços do Cloud Run. Esses registros são criados automaticamente.
- Registros de contêiner (serviços e jobs): registros emitidos pelas instâncias, normalmente do próprio código, gravados em locais compatíveis, conforme descrito em Como gravar registros de contêiner.
- Registros do sistema (serviços e jobs): registros gerados pela plataforma que contêm informações sobre
seus serviços e jobs. Esses registros são gravados em
varlog/system
.
Ver registros
É possível ver registros do serviço ou job de várias maneiras:
- Usar a página do Cloud Run no console do Google Cloud
- Usando a CLI do Google Cloud CL para ver registros pela gcloud (apenas serviços)
- Usar o Explorador de registros do Cloud Logging no Console do Google Cloud
- Usar o Cloud Code
Os dois métodos de console da visualização de registros examinam os mesmos registros armazenados no Cloud Logging, mas o explorador de registros do Cloud Logging fornece mais detalhes e mais recursos de filtragem.
Ver registros no Cloud Run
É possível ver registros de serviços e jobs nas páginas de serviço e jobs correspondentes.
Ver registros de um serviço
Para visualizar os registros na página do Cloud Run, siga estas etapas:
Clique no serviço de sua escolha na lista exibida.
Clique na guia REGISTROS para receber os registros de solicitação e contêiner para todas as revisões desse serviço. É possível filtrar por nível de gravidade de registro.
Ver registros de um job
Para visualizar os registros na página do Cloud Run, siga estas etapas:
Clique na guia JOBS.
Localize o job na lista e clique nele.
Clique na guia REGISTROS para acessar os registros do contêiner de todas as execuções desse job. É possível filtrar por nível de gravidade de registro.
Como alternativa, se você quiser ver os registros pré-filtrados de uma execução de job específica, clique na execução do job e na guia REGISTROS.
Ver registros de serviços usando a Google Cloud CLI
É possível usar a Google Cloud CLI para visualizar os registros de cauda ou ler os registros de um serviço do Cloud Run na linha de comando Por padrão, os registros são formatados em uma linha e otimizados para o console.
Para acompanhar os registros, instale o componente log-streaming
na
Google Cloud CLI. Se o componente não estiver instalado, você vai receber uma solicitação
para instalá-lo quando necessário.
Ver os registros de cauda na linha de comando
Para um serviço do Cloud Run, é possível acompanhar os registros do serviço do Cloud Run em tempo real diretamente na linha de comando:
gcloud beta run services logs tail SERVICE --project PROJECT-ID
Substituir
- SERVICE pelo nome do serviço do Cloud Run.
- PROJECT-ID pelo ID do projeto do Google Cloud. Para ver o ID do projeto, execute o comando
gcloud config get-value project
.
Ler registros na linha de comando
Para um serviço do Cloud Run, é possível ler os registros de duas maneiras:
- Em um formato otimizado para o console:
gcloud run services logs read SERVICE --limit=10 --project PROJECT-ID
- Diretamente do Cloud Logging:
gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=SERVICE" --project PROJECT-ID --limit 10
Substituir
- SERVICE pelo nome do serviço do Cloud Run.
- PROJECT-ID pelo ID do projeto do Google Cloud. Para ver o ID do projeto, execute o comando
gcloud config get-value project
.
Ver registros no Cloud Logging
Para ver os registros do Cloud Run no Explorador de registros do Cloud Logging:
Acesse o Explorador de registros no Console do Google Cloud:
Selecione um projeto atual do Google Cloud na parte superior da página ou crie um novo.
Usando os menus suspensos, selecione o recurso Revisão do Cloud Run para um serviço ou Job do Cloud Run para um job.
Para mais informações, consulte Como usar o Explorador de registros.
Ver os registros de serviços no Cloud Code
Para visualizar registros no Cloud Code, leia os guias do IntelliJ e do Visual Studio Code.
Ler registros de maneira programática
Se você quiser ler os registros de maneira programática, use um destes métodos:
- Use um coletor de registros para o Pub/Sub e um script para receber do Pub/Sub.
- Chame a API Logging usando as bibliotecas de cliente da linguagem de programação sendo usada.
- Chame diretamente os endpoints da API REST do Logging.
Entender os registros de escalonamento de instância
Quando novas instâncias são iniciadas para seu serviço, o Cloud Logging
inclui entradas de registro no nome de registro varlog/system
para refletir por que cada
instância foi criada. A entrada de registro segue este formato:
Starting new instance. Reason: REASON - DESCRIPTION
A tabela a seguir mostra um detalhamento das descrições de instâncias:
Motivo | Descrição |
---|---|
CUSTOMER_MIN_INSTANCE |
Instância mínima configurada pelo cliente para o serviço. |
SCHEDULED |
A instância foi iniciada devido a fatores de escalonamento configurados (por exemplo, utilização da CPU, taxa de transferência de solicitações etc.) e aos respectivos destinos. |
OVERFLOW |
A instância foi iniciada porque não foi encontrada capacidade para o tráfego atual. |
Gravar registros de contêiner
Quando você grava registros do serviço ou job, eles são coletados automaticamente pelo Cloud Logging, desde que os registros sejam gravados em qualquer um dos seguintes locais:
- Streamings de saída padrão (
stdout
) ou de erro padrão (stderr
) - Todos os arquivos no diretório
/var/log
- syslog (
/dev/log
) - Registros gravados usando as bibliotecas de cliente do Cloud Logging, disponíveis para muitas linguagens conhecidas
Espera-se que a maioria dos desenvolvedores grave registros usando a saída e o erro padrão.
Os registros de contêiner gravados nesses locais compatíveis são associados automaticamente ao serviço, à revisão e ao local do Cloud Run ou ao job do Cloud Run. As exceções contidas nos registros são capturadas e informadas no Error Reporting.
A geração de registros integrada equilibra confiabilidade e uso de recursos e funciona para a maioria dos aplicativos. Se o aplicativo tiver requisitos para maior volume ou confiabilidade, recomendamos usar a API Cloud Logging diretamente, seja como uma biblioteca no aplicativo ou como um contêiner de arquivo secundário separado.
Como usar texto simples ou JSON estruturado nos registros
Ao gravar registros, é possível enviar uma string de texto simples ou uma única linha de JSON serializado, também chamado de dados "estruturados". Ela é selecionada e analisada pelo Cloud Logging e colocada em jsonPayload
. Por outro lado, a mensagem de texto simples é colocada em textPayload
.
Gravar registros estruturados
O snippet a seguir mostra como gravar entradas de registro estruturadas. Ele também mostra como correlacionar mensagens de registro com o registro de solicitação correspondente.
Node.js
Python
Go
A estrutura de cada entrada de registro é fornecida por um tipo Entry
:
Quando uma estrutura de entrada é registrada, o método String
é chamado para organizá-la no formato JSON esperado pelo Cloud Logging:
Java
Ativar a geração de registros JSON com Logback e SLF4J acionando o Codificador JSON do Logstash (links em inglês) na configuração do logback.xml
.
Personalize nomes de campo padrão para excluir conteúdo indesejado da ingestão no payload de registros. Para ver uma lista de nomes de campo e formatos de dados esperados, consulte Usar o agente do Logging.
Campos JSON especiais nas mensagens
Quando você fornece um registro estruturado como um dicionário JSON, alguns campos especiais são retirados do jsonPayload
e gravados no campo correspondente no LogEntry gerado, conforme descrito na documentação sobre campos especiais.
Por exemplo, se o JSON incluir uma propriedade severity
, ela será removida do jsonPayload
e aparecerá como severity
da entrada de registro.
A propriedade message
é usada como o texto de exibição principal da entrada de registro, se houver.
Para mais informações sobre propriedades especiais, leia a seção Recurso de geração de registros abaixo.
Correlacionar os registros de contêiner com um registro de solicitação (somente serviços)
No explorador de registros, os registros correlacionados pelos mesmos trace
são
visíveis no formato “pai-filho”: quando você clicar no ícone
de triângulo à esquerda da entrada de registro de solicitação, os registros do contêiner relacionados a essa
solicitação aparecerão aninhados no registro da solicitação.
Os registros de contêiner não são correlacionados automaticamente com os registros de solicitação, a menos que você use uma biblioteca de cliente do Cloud Logging.
Para correlacionar registros de contêineres com os registros de solicitação sem usar uma biblioteca de cliente, use uma linha de registro JSON estruturado que contenha um campo logging.googleapis.com/trace
com o identificador de trace extraído do cabeçalho X-Cloud-Trace-Context
, como mostrado na amostra acima para geração de registros estruturados.
Controlar o uso de recursos de registro de solicitações (somente serviços)
Os registros de solicitação são criados automaticamente. Não é possível controlar a quantidade de registros de solicitação diretamente do Cloud Run, mas é possível usar o recurso de exclusão de registros do Cloud Logging.
Uma observação sobre agentes do Logging
Se você usou o Cloud Logging com determinados produtos do Google Cloud, como o Compute Engine, é possível que tenha usado agentes do Cloud Logging. O Cloud Run não usa agentes do Logging porque tem suporte integrado para a coleta de registros.
Nomes de recursos do Logging
Os nomes dos recursos de geração de registros do Cloud Run são:
- Revisão do Cloud Run (
cloud_run_revision
). - Job do Cloud Run (
cloud_run_job
).
Recursos do Logging
Clicar em uma entrada de registro no explorador de registros abre uma entrada de registro formatada em JSON para que você possa detalhar o que você quer.
Todos os campos em uma entrada de registro, como carimbos de data/hora, gravidade e httpRequest
, são padrão e estão descritos na documentação sobre a entrada de registro.
O Cloud Run adiciona outros metadados para que você possa identificar a origem de um registro. Isso inclui os rótulos definidos no serviço do Cloud Run e os rótulos de recursos específicos do Cloud Run.
Campos de entrada de registro para um serviço
Veja a seguir uma lista dos campos que podem ser encontrados na entrada de registro de um serviço do Cloud Run:
Campo | Valores e observações |
---|---|
LogEntry.labels.instanceId |
A instância que processou a solicitação. |
LogEntry.labels. mylabel,LogEntry.labels. mysecondlabel |
Os rótulos definidos por você no serviço. |
LogEntry.logName |
Identifica o registro, por exemplo, registro de solicitação, erro padrão, saída padrão etc. |
LogEntry.resource.labels.location |
Identifica o local do serviço do Google Cloud. |
LogEntry.resource.labels.project_id |
O projeto em que o serviço está implantado. |
LogEntry.resource.labels.revision_name |
A revisão que atendeu à solicitação. |
LogEntry.resource.labels.service_name |
O serviço que atendeu à solicitação. |
LogEntry.resource.type |
cloud_run_revision . O tipo de recurso do Cloud Run. |
Veja um exemplo de entrada de registro de solicitação de um serviço do Cloud Run:
{
httpRequest: {…}
insertId: "5c82b3d1000ece0000000000"
labels: {
instanceId: "00bf4bf00000fb59c906a00000c9e29c2c4e06dce91500000000056008d2b6460f163c0057b97b2345f2725fb2423ee5f0bafd36df887fdb1122371563cf1ff453717282afe000001"
mylabel: "mylabelvalue"
mysecondlabel: "mysecondlabelvalue"
}
logName: "projects/my-project/logs/run.googleapis.com%2Frequests"
receiveTimestamp: "2019-03-08T18:26:25.981686167Z"
resource: {
labels: {
configuration_name: "myservice"
location: "us-central1"
project_id: "my-project"
revision_name: "myservice-00002"
service_name: "myservice"
}
type: "cloud_run_revision"
}
severity: "INFO"
timestamp: "2019-03-08T18:26:25.970397Z"
}
Campos de entrada de registro para jobs
Veja a seguir uma lista dos campos que podem ser encontrados na entrada de registro do Cloud Run:
Campo | Valores e observações |
LogEntry.labels.instanceId | A instância. |
LogEntry.labels.mylabel,
LogEntry.labels.mysecondlabel |
Os identificadores definidos por você no job. |
LogEntry.logName | Identifica o registro, por exemplo, registro de solicitação, erro padrão, saída padrão etc. |
LogEntry.resource.labels.location | Identifica o local do serviço do Google Cloud. |
LogEntry.resource.labels.project_id | O projeto em que o serviço está implantado. |
LogEntry.resource.labels.job_name | O nome do job. |
LogEntry.labels.execution_name | O nome da execução do job. |
LogEntry.labels.task_index | O índice da tarefa. |
LogEntry.labels.task_attempt | Indica quantas vezes essa tarefa foi tentada. |
LogEntry.resource.type | cloud_run_job . O tipo de recurso do Cloud Run.
|