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.
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
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/activemq.consumer.count
|
|
GAUGE , INT64 gce_instance |
broker destination
|
workload.googleapis.com/activemq.disk.store_usage
|
|
GAUGE , DOUBLE gce_instance |
|
workload.googleapis.com/activemq.disk.temp_usage
|
|
GAUGE , DOUBLE gce_instance |
|
workload.googleapis.com/activemq.memory.usage
|
|
GAUGE , DOUBLE gce_instance |
broker destination
|
workload.googleapis.com/activemq.message.current
|
|
GAUGE , INT64 gce_instance |
broker destination
|
workload.googleapis.com/activemq.message.dequeued
|
|
CUMULATIVE , INT64 gce_instance |
broker destination
|
workload.googleapis.com/activemq.message.enqueued
|
|
CUMULATIVE , INT64 gce_instance |
broker destination
|
workload.googleapis.com/activemq.message.expired
|
|
CUMULATIVE , INT64 gce_instance |
broker destination
|
workload.googleapis.com/activemq.message.wait_time.avg
|
|
GAUGE , DOUBLE gce_instance |
broker destination
|
workload.googleapis.com/activemq.producer.count
|
|
GAUGE , INT64 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.