Como gerar e visualizar registros

Nesta página, descrevemos os registros disponíveis ao usar o Cloud Run para Anthos no Google Cloud e como visualizar e gravar registros.

O Cloud Run para Anthos no Google Cloud tem dois tipos de registros, e eles são enviados automaticamente para o Cloud Logging:

  • Registros de solicitações: registros de solicitações enviados ao Cloud Run para Anthos nos serviços do Google Cloud. Esses registros são criados automaticamente.
  • Registros de contêiner: registros emitidos das instâncias de contêiner, normalmente de seu próprio código, gravados em locais compatíveis, conforme descrito em Como gravar registros de contêiner.

Como ver registros

É possível ver os registros do seu serviço de duas maneiras:

  • Usar a página do Cloud Run para Anthos no Google Cloud no Console do Cloud
  • Usar o Visualizador de registros do Cloud Logging no Console do Cloud.

Esses dois métodos de visualização examinam os mesmos registros armazenados no Cloud Logging, mas o Visualizador de registros fornece mais detalhes e mais recursos de filtragem.

Como visualizar registros no Cloud Run para Anthos no Google Cloud

Para visualizar os registros na página do Cloud Run para Anthos no Google Cloud:

  1. Acesse o Cloud Run for Anthos no Google Cloud

  2. Clique no serviço de sua escolha na lista exibida.

  3. 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.

Como ver registros no Cloud Logging

Para visualizar os registros do Cloud Run para Anthos no Google Cloud no visualizador de registros do Cloud Logging:

  1. Acesse a página Visualizador de registros no Console do Cloud.

    Acessar a página "Visualizador de registros".

  2. Selecione um projeto existente do Google Cloud na parte superior da página ou crie um novo.

  3. Usando os menus suspensos, selecione o recurso: Kubernetes Container.

Para mais informações, leia Como visualizar registros no Logging do pacote de operações do Google Cloud.

Como visualizar registros no Cloud Code

Para visualizar registros no Cloud Code, leia os guias do IntelliJ e do Visual Studio Code.

Como ler registros de maneira programática

Se você quiser ler os registros de maneira programática, use um destes métodos:

Como gravar registros de contêiner

Quando você grava registros do seu serviço, eles serão coletados automaticamente pelo Cloud Logging, desde que os registros sejam gravados em qualquer um dos seguintes locais:

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 automaticamente associados ao serviço, à revisão e ao local do Cloud Run para Anthos no Google Cloud.

Como correlacionar registros de contêiner com um registro de solicitação

No visualizador 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.

Como controlar o uso do recurso de registro de solicitações

Os registros de solicitação são criados automaticamente. Embora não seja possível controlar a quantidade de registros de solicitação diretamente do Cloud Run para Anthos no Google Cloud, é 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 para Anthos no Google Cloud não usa agentes de geração de registros porque tem suporte integrado para a coleta de registros.

Recurso de geração de registros

Clicar em uma entrada de registro no visualizador 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.

No entanto, há alguns rótulos de rótulos ou recursos especiais para o Cloud Run para Anthos no Google Cloud. Eles estão listados aqui com o conteúdo de exemplo:

{
 httpRequest: {…}
 insertId:  "5c82b3d1000ece0000000000"
 labels: {
  instanceId:  "00bf4bf00000fb59c906a00000c9e29c2c4e06dce91500000000056008d2b6460f163c0057b97b2345f2725fb2423ee5f0bafd36df887fdb1122371563cf1ff453717282afe000001"
 }
 logName:  "projects/my-project/logs/kuberun/.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:  "k8s_container"
 }
 severity:  "INFO"
 timestamp:  "2019-03-08T18:26:25.970397Z"
}
Campo Valores e observações
instanceId A instância do contêiner que processou a solicitação.
logName Identifica o registro, por exemplo, registro de solicitação, erro padrão, saída padrão etc.
configuration_name O recurso "Configuração" que criou a revisão que atendeu à solicitação.
location Identifica o local do serviço do GCP.
project_id O projeto em que o serviço está implantado.
revision_name A revisão que atendeu à solicitação.
service_name O serviço que atendeu à solicitação.
type k8s_container O tipo de recurso do Cloud Run para Anthos no Google Cloud.