Integre o rastreamento de ponta a ponta às suas tarefas agendadas para consultar a duração da execução e analisar exceções. Em cenários de microsserviços distribuídos, a cadeia de chamadas de uma tarefa agendada costuma ser mais longa que a de um service em tempo real. A visualização do rastreamento mostra como cada nó de service na cadeia é executado.
Limites
O rastreamento de ponta a ponta é compatível apenas com os seguintes tipos de tarefa: tarefas autônomas (incluindo tarefas HTTP), tarefas de broadcast e tarefas Map visualizadas. Confirme se o seu tipo de tarefa é suportado antes de configurar a integração.
Pré-requisitos
A versão do cliente SchedulerX deve ser 1.7.0 ou superior.
O cliente SchedulerX inclui a dependência do plugin de rastreamento. Para obter instruções, consulte Add the trace plugin dependency.
A aplicação utiliza a Professional Edition. Para obter instruções.
Etapa 1: Escolher um método de integração
O modo de implantação e o backend de rastreamento determinam como a aplicação reporta dados de rastreamento e qual plugin de rastreamento você adiciona na Etapa 2. Escolha o método correspondente à sua configuração atual:
|
Sua configuração atual |
Método |
|
A aplicação já executa no EDAS. |
Opção 1 (recomendada) |
|
A aplicação executa fora do EDAS e você usa o ARMS como backend de rastreamento. |
Opção 2 |
|
Você já opera uma plataforma de rastreamento autogerenciada, como o SkyWalking. |
Opção 3 |
Opção 1: Implantar a aplicação no EDAS (recomendado)
Utilize este método se os services da sua aplicação já estiverem em execução no EDAS ou se você planeja implantá-los nessa plataforma. Aplicações implantadas no EDAS integram o rastreamento de ponta a ponta automaticamente, eliminando a necessidade de instalar agentes.
Caso já utilize o EDAS para implantar os services da sua aplicação, o rastreamento de ponta a ponta já está integrado. Pule as etapas de implantação nesta seção.
Se ainda não utiliza o EDAS, ative-o e implante sua aplicação nele. Aplicações implantadas no EDAS integram o rastreamento de ponta a ponta sem configurações adicionais. Para obter instruções, consulte Get started with EDAS.
Opção 2: Instalar o agente ARMS em uma implantação autônoma
Esta opção é adequada quando você mesmo implanta a aplicação e utiliza o ARMS como backend de rastreamento. Conclua as seguintes etapas durante o processo de integração da aplicação no ARMS:
Baixe o pacote JAR necessário conforme solicitado.
Configure as informações correspondentes da aplicação.
Adicione a configuração do agente Java do ARMS ao script de inicialização da aplicação.
Inicie a aplicação. A integração entra em vigor após a inicialização.
Para obter instruções, consulte Manually install the ARMS agent.
Opção 3: Conectar uma plataforma de rastreamento autogerenciada
Recomendada para ambientes que já operam uma plataforma de rastreamento de ponta a ponta autogerenciada. Os passos abaixo utilizam o SkyWalking, uma plataforma autogerenciada comum, como exemplo.
Baixe o pacote de instalação do agente SkyWalking e conclua a configuração.
Adicione o seguinte parâmetro JVM ao script de inicialização da aplicação Java:
-javaagent:{agent.path}/skywalking-agent.jar.-
Ao adicionar a dependência do plugin de rastreamento na Etapa 2, utilize o plugin do SkyWalking em vez do plugin OpenTelemetry, conforme o exemplo a seguir.
<dependency> <groupId>com.aliyun.schedulerx</groupId> <artifactId>schedulerx-plugin-trace-skywalking</artifactId> <version>{latest_version}</version> </dependency>
Etapa 2: Adicionar a dependência do plugin de rastreamento
Adicione as dependências ao arquivo pom.xml da sua aplicação. O exemplo abaixo utiliza o starter do Spring Boot com o plugin de rastreamento OpenTelemetry. Se você conectar uma plataforma SkyWalking autogerenciada (Opção 3), use o plugin de rastreamento do SkyWalking.
<dependency>
<groupId>com.aliyun.schedulerx</groupId>
<artifactId>schedulerx2-spring-boot-starter</artifactId>
<version>{latest_version}</version>
<!-- If you use logback, exclude log4j and log4j2. -->
<exclusions>
<exclusion>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</exclusion>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- Add the OpenTelemetry trace plugin dependency. -->
<dependency>
<groupId>com.aliyun.schedulerx</groupId>
<artifactId>schedulerx-plugin-trace-opentelemetry</artifactId>
<version>{latest_version}</version>
</dependency>
<!-- If you use SkyWalking, use this plugin instead. -->
<!--<dependency>
<groupId>com.aliyun.schedulerx</groupId>
<artifactId>schedulerx-plugin-trace-skywalking</artifactId>
<version>{latest_version}</version>
</dependency>-->Etapa 3: Visualizar cadeias de chamadas
Após concluir a configuração anterior e implantar a aplicação, a visualização do rastreamento de ponta a ponta estará disponível quando uma tarefa agendada de um tipo suportado for executada. Execute a tarefa e siga o procedimento abaixo para abrir sua cadeia de chamadas no console.
A coleta de dados de rastreamento de ponta a ponta utiliza uma taxa de amostragem padrão, portanto, nem todas as cadeias de chamadas são coletadas. Defina a taxa de amostragem de acordo com o seu cenário de negócios.
Faça login no console do MSE SchedulerX.
Faça login no console do EDAS.
Na barra de navegação à esquerda, clique em Task Scheduling.
Na barra de menus superior, selecione uma região.
No painel de navegação à esquerda, clique em Execution List, selecione a aba Task instance List e utilize o caminho correspondente ao seu tipo de tarefa na coluna Actions.
Tarefas autônomas
Clique em Tracing Analysis ou clique em Details e, em seguida, clique no TraceId para abrir a cadeia de chamadas dessa execução. Tarefas HTTP autônomas também são suportadas, pois a aplicação à qual o service pertence é implantada com a capacidade de rastreamento de ponta a ponta (com suporte a OpenTelemetry).
Tarefas de broadcast
Clique em Details. Na página Task instance details, clique em Current execution details. Um TraceId é exibido para cada máquina. Clique em um TraceId para visualizar a cadeia de chamadas dessa máquina.
Tarefas Map visualizadas
Clique em Details. Na página Task instance details, clique em Subtask list. As tarefas Map visualizadas fornecem visualização da cadeia de chamadas para cada subtarefa em um registro de execução. Na lista de subtarefas dos detalhes do registro de execução, visualize o TraceId de cada subtarefa e clique nele para ver a cadeia de chamadas correspondente.