Ao correlacionar entradas de registro do Cloud Logging com traces e períodos do Cloud Trace, é possível ver os registros junto aos gráficos de cascata de trace ou na Análise de registros ao resolver problemas de solicitações distribuídas. Para vincular registros a
rastreamentos, defina manualmente os campos trace, spanId e traceSampled em um objeto
LogEntry ou use bibliotecas de cliente do Logging
para preencher esses campos automaticamente com o contexto do OpenTelemetry
ou cabeçalhos de solicitação HTTP.
Associar manualmente uma entrada de registro a um trace ou período
Se você usa a API Cloud Logging para gravar dados de registro ou se grava dados de registro estruturados, é possível associar uma entrada de registro a um rastreamento ou um intervalo. A entrada de registro também pode registrar se o rastreamento foi coletado por amostragem. Para informações sobre como o Agente de operações converte dados de registro estruturados em campos em um LogEntry, consulte Campos especiais em payloads estruturados.
Para associar uma entrada de registro a um rastreamento, defina o campo trace
no objeto LogEntry:
- Formato preferido:
TRACE_ID - Formato legado:
projects/PROJECT_ID/traces/TRACE_ID
Nas expressões anteriores, PROJECT_ID é o ID do projeto Google Cloud , e TRACE_ID é o identificador de rastreamento.
Para associar uma entrada de registro a um período usando a API Logging,
defina o campo spanId no objeto LogEntry
como a codificação hexadecimal de 16 caracteres do ID do período.
Por exemplo, para associar uma entrada de registro a um período com o ID 74, defina o ID do período como 000000000000004a.
Para indicar que você está usando a amostragem de rastreamento e que o rastreamento foi amostrado
para armazenamento quando a entrada de registro foi gravada, defina o campo traceSampled no
objeto LogEntry. Ao usar a amostragem de rastreamento, é possível que uma entrada de registro seja criada quando o rastreamento em si não é capturado.
Associar automaticamente uma entrada de registro a um trace ou período
As bibliotecas de cliente de geração de registros podem definir automaticamente os campos de rastreamento em alguns casos. Os valores definidos manualmente têm precedência sobre os valores definidos automaticamente.
Por exemplo, se você estiver usando o OpenTelemetry e registrando de um período ativo do OpenTelemetry, os campos de rastreamento na entrada de registro serão preenchidos com o Contexto do OpenTelemetry.
Em alguns casos, quando uma solicitação HTTP está presente, os campos de rastreamento podem ser definidos no campo W3C traceparent ou no valor X-Cloud-Trace-Context na solicitação HTTP.
Para mais informações sobre o preenchimento automático de campos de rastreamento em entradas de registro, consulte a documentação da biblioteca de cliente específica da linguagem a seguir:
Como visualizar registros
É possível conferir a entrada de registro de um trace junto ao gráfico de cascata ou na Análise de registros. Quando você usa a Análise de registros, o período é automaticamente restrito ao intervalo de carimbo de data/hora do trace. Se não houver entradas de registro para mostrar, a Análise de registros vai exibir a mensagem No entries found matching current filter.
Para ver a entrada de registro do trace no painel Detalhes do trace, faça o seguinte:
Para mostrar as entradas de registro de rastreamento ao lado do gráfico de cascata, acesse o gráfico e clique em Mostrar registros. Quando Mostrar registros não for exibido, nenhuma entrada de registro estará disponível.
Para ver a entrada de registro na Análise de registros, clique em Ver ao lado do rótulo Registro na seção Detalhes. Quando você tiver um rastreamento do Cloud Load Balancing, clique em Visualizar ao lado do rótulo Registro da VM.
Para mais informações sobre como visualizar entradas de registro no Logging, consulte Como usar a Análise de registros.
Permissões para visualização de registros
Para ver as entradas de registro, você precisa ter a permissão logging.logEntries.list no projeto. Essa permissão é fornecida pelos papéis de gerenciamento de identidade e acesso (IAM) do Visualizador de registros e do
Visualizador do projeto.
Para ver os registros da instância de VM, você precisa ter a permissão compute.instances.get no projeto. Essa permissão é oferecida pelos papéis do IAM do Visualizador de rede do Compute
Engine e do Visualizador do projeto.