Configurar eventos de interação personalizados - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

Os eventos de interação são fundamentais para a análise de dados. Alterar as dimensões dos dados e a granularidade da análise proporciona insights mais profundos. A análise de traces permite definir eventos de interação para os campos e atributos de um span. Os tipos de eventos de interação disponíveis incluem:

Open Logstore: Redireciona para a página de um Logstore de destino no Simple Log Service (SLS).
Custom HTTP Link: Redireciona para uma URL HTTP de destino.
Open in Editor: Exibe o valor do campo em formato de texto ou JSON em uma janela pop-up.
Open Saved Search: Redireciona para a página de uma busca salva de destino no Simple Log Service (SLS).

Adicionar um evento de interação personalizado

Na página Trace Explorer, clique em TraceID de um trace.
Selecione um span de destino e, no painel Span Details à direita, clique em Event Config.
No painel Drilldown Config, selecione o escopo do evento de interação.

Existem dois escopos para eventos personalizados: service event configuration e global event configuration. A configuração de evento de serviço aplica-se apenas aos traces do aplicativo atual, enquanto a configuração de evento global abrange todos os traces na região atual.

Na aba service event configuration, clique em Add Field para adicionar os campos SpanId e TraceID.
Clique em Add Field, selecione o campo a ser configurado para o evento e clique em OK.
Clique em Add Event e selecione um evento de interação na lista suspensa.

Os eventos de interação disponíveis incluem Open Logstore, Custom HTTP Link, Open in Editor e Open Saved Search.
Configure os parâmetros do evento e clique em OK.

Para obter detalhes sobre os parâmetros, consulte Parâmetros de eventos de interação.

Na aba service event configuration, adicione um evento para o campo SpanId. Defina o Custom Name e selecione o Text Type. Para adicionar mais eventos de interação, clique em Add Event.

Acionar um evento personalizado

No painel Span Details, passe o mouse sobre um campo destacado em azul. Uma dica de ferramenta exibirá os eventos personalizados configurados. Clique em nome de um evento para acionar o evento de interação.

Por exemplo, ao passar o mouse sobre o valor do campo SpanId, a seção Custom Events no menu pop-up mostra os eventos configurados, como Open in Editor e Query Associated Logs.

Parâmetros de eventos de interação

Open Logstore

Ao acionar o evento de interação Open Logstore, o console redireciona você para a página do Logstore SLS de destino.

Pré-requisitos

O Logstore de destino já deve estar criado. Para mais informações, consulte Gerenciar Logstores.

Parâmetros

Parameter	Required	Description
Custom name	Sim	Nome do evento de interação personalizado. Este nome aparece na dica de ferramenta do evento personalizado.
Select region	Sim	Região onde está localizado o projeto SLS de destino.
Select project	Sim	Nome do projeto SLS de destino.
Select logstore	Sim	Nome do Logstore de destino. Ao acionar o evento de interação, o console redireciona para este Logstore.
Open in new window	Não	Se esta opção estiver ativada, o Logstore de destino abre em uma nova janela do navegador ao acionar o evento de interação.
Time range	Não	Define o intervalo de tempo da consulta para o Logstore de destino. Opções: Preset: Após abrir o Logstore de destino, o SLS usa o intervalo de tempo de consulta padrão (15 minutos relativos). Inherit current query time: Ao abrir o Logstore de destino, o intervalo de tempo da consulta é herdado da página Trace Analysis no momento em que se aciona o evento de interação. Inherit data point time: Ao abrir o Logstore de destino, o horário inicial da consulta corresponde ao valor de Time Range Field menos o Time Range Offset, e o horário final corresponde ao valor de Time Range Field mais o Time Range Offset. Relative Time: Ao abrir o Logstore de destino, o horário da consulta segue o intervalo de tempo relativo especificado. Time Frame: Ao abrir o Logstore de destino, o horário da consulta segue o período de tempo especificado.
Filter statement	Não	Insira uma instrução de filtro. O sistema sincroniza essa instrução com o Logstore de destino e a adiciona antes da instrução de consulta usando o operador `AND`. Clique em Add Variable na instrução de filtro para inserir valores de campo como condições de filtragem. Exemplo: `traceId=${{TraceID}} AND spanId=${{SpanId}}`

Custom HTTP Link

Ao acionar o evento de interação Custom HTTP Link, o console redireciona você para a URL HTTP de destino.

Pré-requisitos

Uma URL HTTP deve estar disponível.

Parâmetros

Parameter	Required	Description
Custom name	Sim	Nome do evento de interação personalizado. Este nome aparece na dica de ferramenta do evento personalizado.
Protocol	Sim	Protocolo da URL HTTP, como HTTP ou HTTPS.
URL	Sim	URL de destino. O caminho na URL HTTP representa o caminho hierárquico até o recurso de destino. Clique em Add Variable para inserir variáveis no caminho da URL. Ao clicar em link, o sistema substitui as variáveis pelos valores de campo correspondentes e redireciona para a URL atualizada.
Encode URL	Não	Se você ativar Encode URL, o conteúdo do link será codificado como URL.
Open in new window	Não	Se esta opção estiver ativada, a URL HTTP de destino abre em uma nova janela do navegador ao acionar o evento de interação.

Open in Editor

Ao acionar o evento de interação Open in Editor, o console exibe o valor do campo em formato de texto ou JSON em uma janela pop-up.

Parameter	Required	Description
Custom name	Sim	Nome do evento de interação personalizado. Este nome aparece na dica de ferramenta do evento personalizado.
Text type	Não	Formato de exibição do valor do campo. Valores válidos: Text e JSON.

Open Saved Search

Ao acionar o evento de interação Open Saved Search, o console redireciona você para a página de busca salva do SLS de destino.

Pré-requisitos

Uma busca salva de destino já deve estar criada no SLS. Para mais informações, consulte Buscas salvas.

Para usar variáveis, configure-as na instrução de consulta da busca salva de destino. Para mais informações, consulte Ajustar dinamicamente parâmetros de instrução de consulta usando variáveis.

Parâmetros

Parameter	Required	Description
Custom name	Sim	Nome do evento de interação personalizado. Este nome aparece na dica de ferramenta do evento personalizado.
Select region	Sim	Região onde está localizado o projeto SLS de destino.
Select project	Sim	Nome do projeto SLS de destino.
Select saved search	Sim	Busca salva de destino no SLS. Após acionar o evento de interação, o console abre a página desta busca salva.
Open in new window	Não	Se esta opção estiver ativada, a página da busca salva de destino abre em uma nova janela do navegador ao acionar o evento de interação.
Time range	Não	Define o intervalo de tempo da consulta para a busca salva de destino. Opções: Preset: Após abrir a página da busca salva de destino, o SLS usa o intervalo de tempo de consulta padrão (15 minutos relativos). Inherit current query time: Ao abrir a página da busca salva de destino, o intervalo de tempo da consulta é herdado da página Trace Analysis no momento em que se aciona o evento de interação. Inherit data point time: Ao abrir a página da busca salva de destino, o horário inicial da consulta corresponde ao valor de Time Range Field menos o Time Range Offset, e o horário final corresponde ao valor de Time Range Field mais o Time Range Offset. Relative Time: Ao abrir a página da busca salva de destino, o horário da consulta segue o intervalo de tempo relativo especificado. Time Frame: Ao abrir a página da busca salva de destino, o horário da consulta segue o período de tempo especificado.
Filter statement	Não	Insira uma instrução de filtro. O sistema sincroniza essa instrução com a página da busca salva de destino e a adiciona antes da instrução de consulta usando o operador `AND`. Clique em Add Variable na instrução de filtro para inserir valores de campo como condições de filtragem.
Dynamic variables	Não	O SLS permite usar variáveis para modificar flexivelmente a instrução de consulta na busca salva de destino. Se uma variável adicionada aqui tiver o mesmo nome de uma variável na consulta da busca salva de destino, o valor do campo que aciona o evento de interação substituirá a variável na instrução de consulta. Nota É possível adicionar até cinco variáveis dinâmicas e cinco variáveis estáticas. Variáveis dinâmicas Variable name: Nome da variável. Variable value column: Coluna cujo valor substitui dinamicamente a variável na consulta da busca salva. Variáveis estáticas Variable name: Nome da variável. Static value: Valor fixo que substitui a variável na consulta da busca salva.
Static variables	Não

Eventos de interação predefinidos

O Trace Analysis inclui os seguintes eventos de interação predefinidos:

Ao clicar em botão direito no valor de um campo de span, um menu de contexto é exibido. Esse menu divide-se nas seções Advanced Configuration e Custom Events. A seção Advanced Configuration mostra eventos integrados, como Query Trace with Current Condition e View Application Details. Já a seção Custom Events exibe os eventos configurados pelo usuário. A opção Event Config, na parte inferior do menu, permite gerenciar os eventos personalizados.

Built-in event	Applicable field	Description
Query Trace with Current Condition	Todos os campos, exceto eventos de span	Adiciona este campo como condição de consulta à pesquisa do Trace Analysis.
View Application Details	Nome do aplicativo (serviceName)	Redireciona para a página Visão geral do Application Monitoring.
View Provided Services	Nome da interface (spanName)	Redireciona para a página Serviços fornecidos do Application Monitoring.
View Instance Monitoring	IP	Redireciona para a página Monitoramento de instância do Application Monitoring.
View Raw Trace Data	TraceID, SpanId	Exibe os dados brutos do trace armazenados no SLS.

Perguntas frequentes

Se você acessar a página Trace Analysis por meio de um nome de domínio virtual (por exemplo, se a página do ARMS estiver incorporada em uma página web autogerenciada), acionar os eventos Open Logstore ou Open Saved Search pode redirecionar você para uma página de login em vez do console SLS. Para contornar esse problema, utilize um evento de interação Custom HTTP Link para obter o mesmo efeito. Siga estas etapas:

Crie um evento de interação Custom HTTP Link.
Selecione https como Protocol e insira a URL de destino no campo URL.
Prepare a URL SLS de destino. Substitua o nome de domínio padrão (sls.console.alibabacloud.com) pelo nome de domínio virtual do SLS (sls4servims.console.alibabacloud.com). Para mais informações, consulte Preparar um link compartilhável. Desative Encode URL e ative Open in new window.
Para transmitir parâmetros de consulta ao redirecionar para o Logstore, clique em Add Variable e selecione as variáveis desejadas.

A URL de exemplo abaixo abre o Logstore chamado test-logstore no projeto test-project e filtra logs onde o traceId é igual ao TraceID do trace atual.
```
https://sls4servims.console.alibabacloud.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{TraceID}}
```