É possível incluir anotações nos traces que permitem associar um trace a um objeto LogEntry do Cloud Logging.
Para mais informações sobre anotações, consulte Como anotar períodos.
Como associar um trace a uma entrada de registro
Ao usar as bibliotecas de cliente do Trace ou a biblioteca do OpenCensus para Python ou Java, você pode associar um trace a uma entrada de registro definindo o campo trace no objeto LogEntry.
O campo trace precisa ser definido como uma string com o seguinte formato:
projects/[PROJECT_ID]/traces/[TRACE_ID]
em que [PROJECT_ID] é o código do projeto do Google Cloud e [TRACE_ID] é o identificador de trace
Você pode associar um período a uma entrada de registro definindo o campo span_id no objeto LogEntry. Nesse caso, defina o campo span_id como a codificação hexadecimal de 16 caracteres do ID do período. Por exemplo, um período com um ID de 74 é representado como 000000000000004a. Ao usar a amostragem de traces, defina o campo
trace_sampled no objeto LogEntry para indicar que o
trace foi amostrado para armazenamento quando a entrada de registro foi gravada. É possível que
uma entrada de registro seja criada quando o trace não for capturado.
- Se você estiver usando Python e OpenCensus, para mais informações sobre a integração com o Cloud Logging, consulte Integração de registros do OpenCensus.
- Se você estiver usando Java e OpenCensus, consulte Correlação de registro do OpenCensus.
- Se você estiver usando o agente do Cloud Logging, consulte a configuração do agente do Cloud Logging.
Ver registros
Você pode ver a entrada de registro de um trace junto com o gráfico de cascata ou no Visualizador de registros. Quando você usa o Visualizador de registros, ele é automaticamente restrito ao intervalo de carimbo de data/hora do trace. Se não houver entradas de registro para exibir, o Visualizador de registros exibirá a mensagem No entries found matching current filter.
No painel Detalhes do trace, para visualizar a entrada de registro do trace, siga um destes procedimentos:
Para exibir as entradas de registro de trace ao lado do gráfico de cascata, acesse o gráfico de cascata 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 no Visualizador de registros, clique em Visualizar ao lado do rótulo Registro na seção Detalhes. Quando você tiver um trace 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 Cloud Logging, consulte Como visualizar 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 é concedida pelos papéis Visualizador de registros e Visualizador do projeto do Cloud Identity and Access Management (Cloud IAM).
Para ver os registros da instância de VM, você precisa ter a permissão compute.instances.get no projeto. Essa permissão é fornecida pelos papéis Visualizador de rede do Compute Engine e Visualizador do projeto do Cloud IAM.