Apache ActiveMQ

A integração do Apache ActiveMQ coleta uso de armazenamento e métricas de mensagens. 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 activemq.apache.org/.

Pré-requisitos

Para coletar e ingerir métricas do ActiveMQ, é preciso instalar o agente de operações versão 2.11.0 ou superior.

Ative a compatibilidade com JMX na configuração do agente.

Este receptor é compatível com as seguintes versões do Apache ActiveMQ:

ActiveMQ: versões clássicas 5.8.x até 5.16.x.
ActiveMQ Artemis versão 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 métricas das instâncias do ActiveMQ e reinicie o agente.

Exemplo de configuração

O comando a seguir cria o arquivo de configuração para coletar e ingerir registros do ActiveMQ e reinicia o agente de operações no Linux.

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

Configurar a coleta de métricas

Para coletar métricas do ActiveMQ, é preciso criar um receptor para as métricas do ActiveMQ e, em seguida, criar um pipeline para o novo receptor. Para configurar um receptor para suas métricas do ActiveMQ, especifique os campos a seguir:

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

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`

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.

Amostra de painel

Para visualizar as métricas dessa integração, use um exemplo de painel do Cloud Monitoring. Conclua os procedimentos de Como instalar painéis de amostra para importar o painel Visão geral do GCE do ActiveMQ da Biblioteca de amostras e ver os gráficos que exibem as métricas do ActiveMQ.

Verificar ingestão

Para verificar se os registros são ingeridos, acesse o Explorador de registros e execute a seguinte consulta para ver os registros do ActiveMQ (substitua activemq pelo nome da unidade do sistema para ActiveMQ, se necessário):

resource.type="gce_instance"
logName="projects/PROJECT_ID/logs/syslog"
activemq

Use o Metrics Explorer para verificar se você configurou corretamente o receptor de métricas do ActiveMQ. Pode levar um ou dois minutos para que o agente de operações comece a coletar métricas.

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.connection.count'
| align rate(1m)
| 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.