Encontre e consulte seus dados do IBM MQ no New Relic

1. Vá para one.newrelic.com > All entities.
2. Filtre por IBMMQ_MANAGER e IBMMQ_QUEUE, ou pesquise o nome de um gerenciador de filas.
3. Abra um gerenciador de filas para ver suas métricas clássicas — conexões, taxas de mensagens put/get — e seu dashboard pré-criado do IBM MQ, com suas filas listadas como entidades relacionadas.

Quando você abre uma entidade IBMMQ_MANAGER, o New Relic mostra um dashboard pré-construído que resume a integridade do gerenciador de filas, conexões, taxas de transferência de mensagens, erros e uso do sistema de arquivos. Abra uma entidade IBMMQ_QUEUE para profundidade por fila, idade da mensagem e taxas de transferência. Você também pode criar o seu próprio — consulte Criar dashboard personalizado.

Gera alertas quando um gerenciador de filas sai do seu estado de execução (2).

FROM Metric SELECT latest(ibmmq_qmgr_status) FACET qmgr, target.name

Limite recomendado: crítico quando o valor não for igual a 2 por pelo menos 2 minutos.

Alertas quando um canal sai do seu estado de execução (3).

FROM Metric SELECT latest(ibmmq_channel_status) FACET qmgr, channel

Limite recomendado: crítico quando o valor não for igual a 3 por pelo menos 5 minutos (para permitir canais que param e iniciam legitimamente).

Alertas quando a profundidade de uma fila se aproxima do seu máximo configurado.

FROM Metric SELECT latest(ibmmq_queue_depth) / latest(ibmmq_queue_attribute_max_depth) * 100 AS 'Depth %' FACET qmgr, queue

Limite recomendado: aviso em 80%, crítico em 95%.

Alertas quando mensagens chegam à fila de mensagens mortas — geralmente um sinal de mensagens não entregues.

FROM Metric SELECT latest(ibmmq_queue_depth) WHERE queue = 'SYSTEM.DEAD.LETTER.QUEUE' FACET qmgr

Limite recomendado: crítico quando o valor é maior que 0.

Isso é quase sempre causado pela alteração do formato da métrica crítica da entidade. A síntese de entidade usa como chave as métricas brutas com sublinhado (ibmmq_*), o rótulo qmgr bruto e um atributo target.name. Verifique se:

• Os nomes das métricas não são separados por pontos (você deve ver ibmmq_queue_depth, não ibmmq.queue.depth).

• O rótulo qmgr está presente e não renomeado (não ibmmq.queue_manager.name).

• target.name é definido nas métricas (e o camelCase targetName não é — se targetName ainda estiver presente, transform/ibmmq-cleanup não está em execução ou está ordenado incorretamente):

  FROM Metric SELECT uniques(target.name), uniques(qmgr) WHERE metricName LIKE 'ibmmq_%' SINCE 30 minutes ago

  Copiar

  A ordem do processador na configuração do coletor é fundamental — resourcedetection → transform/ibmmq-cleanup. Se você reordenou ou removeu transform/ibmmq-cleanup, as métricas do IBM MQ são roteadas para a própria entidade do coletor em vez de uma entidade IBMMQ_MANAGER. Restaure a ordem documentada do pipeline.

O New Relic espera temporalidade delta para contadores; o Prometheus emite cumulativa. O processador cumulativetodelta/ibmmq os converte no local. Se os contadores parecerem planos, confirme se o processador está presente em cada pipeline de métrica.

O valor target.name (definido por meio da env TARGET_NAME no Linux, ou do relabel targetName no Kubernetes) é o primeiro segmento de cada GUID IBMMQ_MANAGER e IBMMQ_QUEUE. Alterá-lo após a implantação cria entidades totalmente novas e as antigas ficam obsoletas, quebrando dashboards e alertas que apontam para os GUIDs antigos. Escolha um valor estável uma vez e nunca o altere.

Se você já o alterou, restaure o valor TARGET_NAME original e reinicie o coletor. As entidades nomeadas corretamente voltam a reportar; as duplicatas criadas com o nome errado param de receber dados e expiram da interface após a janela de relatórios de entidade do New Relic.