Monitorando o ActiveMQ Artemis

O sensor ActiveMQ Artemis é instalado automaticamente após a instalação do agente Instana no host onde o ActiveMQ está em execução.

Após configurar o sensor, você poderá visualizar os hosts monitorados e as métricas relacionadas ao ActiveMQ Artemis na interface do usuário do Instana. Para obter mais informações sobre a configuração do sensor, consulte Configuração.

Informações de suporte

Para garantir que o sensor ActiveMQ Artemis seja compatível com a sua configuração atual, consulte as seguintes seções de informações de suporte:

Versões compatíveis e política de suporte

O sensor ActiveMQ Artemis é compatível com as versões ActiveMQ Artemis, desde 2.0.0 até 2.36.x. O sensor também é compatível com o JBoss ActiveMQ 7 e versões posteriores.

A tabela a seguir mostra a versão mais recente compatível e a política de suporte:

Tecnologia Política de suporte Versão com tecnologia de ponta Versão mais recente suportada
ActiveMQ Artemis Sob demanda 2.52.x 2.52.x

Para obter mais informações sobre a política de suporte, consulte a estratégia de suporte para sensores.

Rastreamento do lado do cliente compatível

Instana suporta rastreamento no lado do cliente para o ` Java `.

Ativando o recurso “ JMX ”

Se o recurso “ JMX ” não estiver ativado, a seguinte mensagem será exibida na interface do usuário do “ Instana ”:

Jmx is not enabled.
You can enable it in activemq config by setting the broker property useJmx to true.

Você pode habilitar o acesso por ` JMX ` removendo <authorisation> o elemento de /apache-artemis/bin/myinstance/etc/management.xml.

Configurando

Para permitir um monitoramento detalhado das métricas, adicione as filas que deseja monitorar ao arquivo de configuração do <agent_install_dir>/etc/instana/configuration.yaml agente. Você também pode definir uma frequência de sondagem personalizada adicionando poll_rate no mesmo arquivo, conforme mostrado na configuração a seguir:


com.instana.plugin.activemqartemis:
  poll_rate: 1 # Value is in seconds. Default value is 1 second.
  monitorQueues:
    - 'test-queue'
    - 'DLQ'
 
Observação: O sensor ActiveMQ Artemis pode monitorar até 100 filas por broker. Certifique-se de que o número de filas especificadas não exceda esse limite.

Configurando a frequência de sondagem

Observação: Instana ActiveMQ Artemis sensor 1.0.9 e versões posteriores oferecem suporte à configuração da taxa de sondagem para reduzir a ingestão de dados. Esse recurso é compatível com o backend 311 e versões posteriores do Instana em servidor próprio.

Você pode definir a frequência com que o Instana consulta o ActiveMQ Artemis para coletar dados e métricas usando o poll_rate parâmetro no arquivo configuration.yaml do agente, conforme mostrado no exemplo a seguir:

com.instana.plugin.activemqartemis:
  poll_rate: 1 # values are in seconds. Default value is 1 second.

Visualizando as métricas

Para visualizar as métricas, conclua as etapas a seguir:

  1. No menu de navegação da interface do usuário do Instana, selecione Infraestrutura.
  2. Clique em um host monitorado específico.

Você pode ver um painel de controle do host com todas as métricas coletadas e os processos monitorados.

Dados de configuração

  • Versão
  • Nome do broker
  • ID do nó
  • Portas
  • Limite de memória
  • Endereços
  • Filas
  • Aceitadores de transporte

Métricas de desempenho

Em todo o broker

Métrica Descrição Granularidade
Mensagens incluídas Número de mensagens que são incluídas no broker e coletadas do activemq.artemis:broker#TotalMessagesAdded. 1 segundo
Mensagens reconhecidas Número de mensagens que são reconhecidas (e removidas) do broker e coletadas do activemq.artemis:broker#TotalMessagesAcknowledged. 1 segundo
Mensagens expiradas Número de mensagens que expiraram no broker e são coletadas da soma de subcomponent=queues#MessagesExpired para todas as filas. 1 segundo
Mensagens interrompidas Número de mensagens que foram interrompidas no broker para exceder o máximo de tentativas de entrega e que são coletadas da soma de subcomponent=queues#MessagesKilled para todas as filas. 1 segundo
Contagem de mensagens A contagem de mensagens em todas as filas que é coletada da soma de subcomponent=queues#MessageCount para todas as filas. 1 segundo
Total de conexões O número de conexões totais no broker que é coletado de activemq.artemis:broker#ConnectionCount. 1 segundo
Total de consumidores O número de consumidores totais no broker que é coletado de activemq.artemis:broker#TotalConsumerCount. 1 segundo
Uso de memória Porcentagem do limite de memória usada por todos os endereços no agente e coletada de activemq.artemis:broker#AddressMemoryUsagePercentage. 1 segundo

Filas

Métrica Descrição Granularidade
Contagem de mensagens O número de mensagens atualmente nessa fila (inclui mensagens planejadas, paginadas e em entrega) que é coletado de subcomponent=queues#MessageCount. 1 segundo
Mensagens incluídas Número de mensagens que são incluídas na fila e coletadas do subcomponent=queues#MessagesAdded. 1 segundo
Mensagens reconhecidas Número de mensagens que são reconhecidas (e removidas) da fila e coletadas do subcomponent=queues#MessagesAcknowledged. 1 segundo
Mensagens expiradas Número de mensagens que expiraram nesta fila e que são coletados de subcomponent=queues#MessagesExpired 1 segundo
Mensagens interrompidas Número de mensagens que foram interrompidas nessa fila devido a exceder o número máximo de tentativas de entrega coletadas do subcomponent=queues#MessagesKilled. 1 segundo

Assinaturas de funcionamento

Cada sensor tem uma base de conhecimento selecionada de assinaturas de integridade que são avaliadas continuamente em relação às métricas recebidas e são usadas para levantar problemas ou incidentes que dependem do impacto sobre o usuário.

Os eventos integrados acionam problemas ou incidentes com base em assinaturas de integridade com falha nas entidades, enquanto os eventos personalizados acionam problemas ou incidentes com base nos limites de uma métrica específica de qualquer entidade.

Para obter informações sobre os eventos integrados do sensor de detecção de movimento ( ActiveMQ Artemis ), consulte a Referência de eventos integrados.