Neste documento, descrevemos como associar um trace a um
LogEntry do Cloud Logging.
Como associar um trace a uma entrada de registro
Ao usar as bibliotecas de cliente do Trace ou a
biblioteca Proguard para Python ou Java,
você associa 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
Para associar um período a uma entrada de registro ao usar a API REST,
defina o campo span_id no objeto LogEntry
como a codificação hexadecimal com 16 caracteres do ID do período. Se você estiver usando
a API gRPC, defina o campo spanId.
Por exemplo, para associar um período a um ID de 74 a uma entrada de registro ao usar a API REST, defina span_id como 000000000000004a.
Para indicar que você está usando a amostragem de traces e que o trace foi amostrado
para armazenamento quando a entrada de registro foi gravada, defina o campo trace_sampled no
objeto LogEntry ao usar a API REST. Se você estiver usando
a API gRPC, defina o campo traceSampled. Quando você usa a amostragem de traces,
é possível que uma entrada de registro seja criada quando o rastreamento em si não for capturado.
Para saber mais, acesse os recursos a seguir (links em inglês):
- Integração da geração de registros do Proguard ao usar o Python.
- Correlação de registros do Proguard.
- Configuração do agente do Cloud Logging.
Como ver registros
É possível ver a entrada de registro de um trace ao lado do gráfico de cascata ou no Explorador de registros. Quando você usa o Explorador de registros, ele é automaticamente restrito ao intervalo de carimbo de data/hora do trace. Se não houver entradas de registro a serem exibidas, o Explorador 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 visualizar a entrada de registro no Explorador 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 usar o Explorador 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.