Apache ActiveMQ

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`
`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.