Apache ActiveMQ

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A integração do Apache ActiveMQ grava registros e coleta métricas de mensagens e uso do armazenamento. As métricas de armazenamento incluem uso de memória e disco. As métricas de mensagens incluem o número de mensagens aguardando, o tempo médio de espera e as mensagens expiradas.

Para mais informações sobre o ActiveMQ, consulte a documentação do Apache ActiveMQ.

Prerequisites

Para coletar a telemetria do ActiveMQ, instale o Agente de operações:

  • Para métricas, instale a versão 2.11.0 ou mais recente.
  • Para registros, instale a versão 2.15.0 ou posterior.

É preciso ativar a compatibilidade com JMX na configuração do agente do ActiveMQ.

Essa integração é compatível com as seguintes versões do ActiveMQ:

  • Classic 5.8.x a 5.16.x
  • Artemis 2.x.

Configurar o agente de operações para ActiveMQ

Seguindo o guia de Como configurar o Agente de operações, adicione os elementos necessários para coletar a telemetria de instâncias do ActiveMQ e reinicie o agente.

Exemplo de configuração

O comando a seguir cria a configuração para coletar e ingerir a telemetria para o ActiveMQ e reinicia o Agente de operações.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    activemq:
      type: activemq
  service:
    pipelines:
      activemq:
        receivers:
          - activemq
EOF

sudo service google-cloud-ops-agent restart

Coletar registros

O ActiveMQ grava registros em syslog, que são capturados pelo Agente de operações por padrão. Não é necessária outra configuração do usuário.

Configurar a coleta de métricas

Para ingerir métricas do ActiveMQ, é preciso criar receptores para as métricas produzidas pelo ActiveMQ e, em seguida, criar um pipeline para os novos receptores.

Para configurar um receptor para suas métricas do activemq, especifique os campos a seguir:

Campo Padrão Descrição
collection_interval 60s Um valor de time.Duration, como 30s ou 5m.
endpoint http://localhost:1099 O URL do nó a ser monitorado.
password Senha configurada se o JMX estiver configurado para exigir autenticação.
type Este valor precisa ser activemq.
username O nome de usuário configurado se o JMX estiver configurado para exigir autenticação.

O que é monitorado?

A tabela a seguir fornece a lista de métricas que o agente de operações coleta da instância do ActiveMQ.

Tipo de métrica 
Tipo, tipo
Recursos monitorados
Rótulos
workload.googleapis.com/activemq.connection.count
GAUGEINT64
gce_instance
 
workload.googleapis.com/activemq.consumer.count
GAUGEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.disk.store_usage
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/activemq.disk.temp_usage
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/activemq.memory.usage
GAUGEDOUBLE
gce_instance
broker
destination
workload.googleapis.com/activemq.message.current
GAUGEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.dequeued
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.enqueued
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.expired
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.wait_time.avg
GAUGEDOUBLE
gce_instance
broker
destination
workload.googleapis.com/activemq.producer.count
GAUGEINT64
gce_instance
broker
destination

Amostra de painel

Para visualizar as métricas do ActiveMQ, é necessário ter um gráfico ou um painel configurado. O Cloud Monitoring disponibiliza uma biblioteca de painéis de amostra para integrações, que contêm gráficos pré-configurados. Para informações sobre a instalação desses painéis, consulte Como instalar painéis de amostra.

Verificar a configuração

Nesta seção, descrevemos como verificar se você configurou corretamente o receptor do ActiveMQ. Pode levar um ou dois minutos para que o agente de operações comece a coletar telemetria.

Para verificar se os registros são ingeridos, acesse o Explorador de registros e execute a consulta a seguir para ver os registros do ActiveMQ:

resource.type="gce_instance"
log_id("syslog")
jsonPayload.message~='(activemq\[[0-9]+\]|activemq):'

Para verificar se as métricas são ingeridas, acesse o Metrics Explorer e execute a seguinte consulta na guia MQL:

fetch gce_instance
| metric 'workload.googleapis.com/activemq.consumer.count'
| every 1m

A seguir

Para ver um tutorial sobre como usar o Ansible para instalar o agente de operações, configurar um aplicativo de terceiros e instalar um painel de amostra, consulte o vídeo Instalação do agente de operações para resolver problemas de aplicativos de terceiros.