Visualização pública
Este recurso é atualmente uma versão prévia pública.
Nossa integração IBM MQ coleta e envia métricas dimensionais do IBM MQ.
Você pode visualizar esses dados métricos em um painel pré-construído, criar políticas de alertas e criar consultas e gráficos personalizados.
dashboard instalado por meio do New Relic IBM MQ monitor início rápido.
Para obter dados da infraestrutura do IBM MQ, nossa integração do IBM MQ usa um exportador Prometheus de terceiros, que expõe a métrica do Prometheus na porta especificada na configuração. A integração recolhe essas métricas, transforma-as em entidade, filtra-as e depois envia-as para a New Relic.
Importante
A integração do IBM MQ não suporta a arquitetura ARM64.
Para instalar a integração de monitoramento do IBM MQ, execute as etapas a seguir:
Compatibilidade e requisitos
Versões do IBM MQ
Nossa integração é compatível com IBM MQ 9.0 ou superior.
Sistema operacional suportado
- Linux
- Windows
Para uma lista abrangente de versões específicas de Linux e Windows, verifique a tabela de sistemas operacionais compatíveis.
Importante
A arquitetura ARM64 não é suportada.
Requisito do sistema
- Instale o agente de infraestrutura, versão mínima 1.24.0.
- Distribuição Linux ou versão Windows compatível com o agente de infraestrutura.
- Biblioteca do IBM MQ Redistributable Client na caixa do agente.
- Verifique ou adicione o caminho da biblioteca na variável de ambiente
LD_LIBRARY_PATH
no Linux ou siga estas etapas no Windows. - Certifique-se de que o monitoramento de estatísticas da fila esteja ativado no MQ.
- Crie um usuário no MQ com permissões somente leitura.
Instalar e ativar
Para instalar a integração, siga as instruções para seu ambiente:
Outros ambientes
Este documento ajudou você na instalação?
Configurar a integração
Para configurar a integração, edite a configuração no arquivo de configuração YAML da integração, ibmmq-config.yml
. A configuração no formato YAML de uma integração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferência. O arquivo de configuração possui configurações comuns aplicáveis a todas as integração.
Para ler tudo sobre essas configurações comuns, consulte nosso documento de formato de configuração .
Configurações da instância do IBM MQ
As seguintes opções de configuração estão disponíveis:
Contexto | Descrição | Padrão |
---|---|---|
hostname | Nome do host do serviço IBM MQ | N/A |
port | Porta do serviço IBM MQ | N/A |
queue_manager | Nome do gerenciador de filas | N/A |
channel | Nome do canal usado para conexão com o gerenciador de filas. Normalmente você pode usar | N/A |
username | Nome de usuário para autenticação no serviço IBM MQ. Se a senha não for especificada, a autenticação de usuário/senha será desabilitada e o nome de usuário não deverá ser especificado na configuração. O exportador se conectará enviando como | N/A |
password | Senha para autenticação no serviço IBM MQ | N/A |
monitored_queues | Filas a serem monitor (curingas e ! para excluir são aceitos) | N/A |
monitored_channels | Canais a serem monitor (curingas e ! para excluir são aceitos) | N/A |
monitored_topics | Tópicos a serem monitor (curingas e ! para excluir são aceitos) | N/A |
monitored_subscriptions | Assinatura para monitor (curingas e ! para excluir são aceitos) | N/A |
exporter_port | Porta para expor endpoint de raspagem. Se isso não for fornecido, uma porta aleatória será usada para lançar o exportador | porta aleatória |
scrape_timeout | Tempo até que uma solicitação de raspagem expire | 5s |
mqsslkeyr | Necessário para configurar o TLS MQSSLKEYR especifica o local do keystore que contém o certificado digital pertencente ao usuário ou ao servidor. Deve ser especificado sem a extensão para apontar para | N/A |
ccdt_url | Necessário para configurar o caminho TLS para o arquivo ccdt. Duas variáveis de ambiente diferentes serão configuradas automaticamente: MQCCDTURL e IBMMQ_CONNECTION_CCDTURL. | N/A |
home | O Cliente IBMMQ precisa de permissões para gravar em um diretório especificado na variável de ambiente HOME. | N/A |
ld_library_path | Variável de ambiente LD_LIBRARY_PATH para o Cliente IBMMQ usado pelo exportador. | N/A |
Arquivos de amostra ibmmq-config.yml
Encontre e use dados
- O New Relic IBM MQ monitor início rápido está disponível por meio de observabilidade instantânea (I/O). Ele fornece um dashboard que permite explorar facilmente seus dados, entender o contexto e resolver problemas com mais rapidez.
- Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.
- métrica estão anexadas à amostra métrica e aos tipos de eventos da entidade
IBMMQ_MANAGER
eIBMMQ_QUEUE
. - Você pode consultar os dados da New Relic para fins de resolução de problemas, ou para criar gráficos e dashboards personalizados.
Dados métricos
São criadas duas entidades: IBMMQ_MANAGER
e IBMMQ_QUEUE
.
As seguintes métricas dimensionais são capturadas raspando o exportador e vinculadas à entidade IBMMQ_MANAGER
:
Nome | Descrição | Dimensões |
---|---|---|
| Recuperação de buffers |
|
| Buffers enviados |
|
| Bytes recuperados |
|
| Bytes enviados |
|
| Tipo de canal de instância |
|
| Mensagens (chamada de API para SVRCONN) |
|
|
| |
| Status do canal - simplificado |
|
| Subestado do canal |
|
| Tempo desde a mensagem |
|
| Tipo de canal |
|
| Alterar contagem de assinaturas duráveis |
|
| Status do iniciador de canal |
|
| Status do servidor de comando |
|
| Contagem de confirmações |
|
| Conexões simultâneas - limite máximo |
|
| Contagem de conexões |
|
| Carga da CPU - média de quinze minutos |
|
| Carga da CPU - média de cinco minutos |
|
| Carga da CPU - média de um minuto |
|
| Crie uma contagem de assinaturas durável |
|
| Criar contagem de assinaturas não duráveis |
|
| Excluir contagem de assinaturas duráveis |
|
| Excluir contagem de assinaturas não duráveis |
|
| Assinante durável - marca d'água alta |
|
| Assinante durável - marca d'água baixa |
|
| Contagem de mensagens expiradas |
|
| Quantas publicações de recursos foram processadas |
|
| Falha na contagem de navegação |
|
| Falha ao criar/alterar/retomar contagem de assinaturas |
|
| Falha na contagem de MQCB |
|
| Falha na contagem de MQCLOSE |
|
| Falha na contagem de MQCONN/MQCONNX |
|
| Falha no MQGET - contagem |
|
| Falha na contagem de MQINQ |
|
| Falha na contagem de MQOPEN |
|
| Falha na contagem de MQPUT |
|
| Falha na contagem de MQPUT1 |
|
| Falha na contagem de MQSET |
|
| Falha na contagem de MQSUBRQ |
|
| Contagem de tópicos MQPUT/MQPUT1 com falha |
|
| Recebeu mensagens não persistentes - contagem de bytes |
|
| Mensagens persistentes recebidas - contagem de bytes |
|
| Intervalo total destrutivo obtido - contagem de bytes |
|
| Contagem destrutiva total de intervalo |
|
| Contagem total de bytes MQPUT/MQPUT1 do intervalo |
|
| Contagem total de MQPUT/MQPUT1 do intervalo |
|
| Intervalo total de bytes do tópico colocados |
|
| Log - espaço primário atual em uso |
|
| Arquivo de log system - bytes em uso |
|
| Arquivo de log do sistema - bytes máx. |
|
| Log - bytes em uso |
|
| Log - bytes lógicos gravados |
|
| Log - máximo de bytes |
|
| Log - bytes físicos gravados |
|
| Log - utilização do espaço primário workload |
|
| Log - latência de escrita |
|
| Log - tamanho da gravação |
|
| Sistema de arquivos de erros do MQ - espaço livre |
|
| Sistema de arquivos de erros do MQ - bytes em uso |
|
| Contagem de arquivos MQ FDC |
|
| Sistema de arquivos trace MQ - espaço livre |
|
| Sistema de arquivos trace MQ - bytes em uso |
|
| Contagem de MQCB |
|
| Contagem MQCLOSE |
|
| Contagem MQCONN/MQCONNX |
|
| Contagem MQCTL |
|
| Contagem MQDISC |
|
| Contagem MQINQ |
|
| Contagem de MQOPEN |
|
| Contagem MQSET |
|
| Contagem MQSTAT |
|
| Contagem MQSUBRQ |
|
| Assinante não durável - limite máximo |
|
| Assinante não durável - marca d'água baixa |
|
| Navegação de mensagens não persistentes - contagem de bytes |
|
| Navegação de mensagens não persistentes - contagem |
|
| Obtenção destrutiva de mensagens não persistentes - contagem |
|
| Contagem de MQPUT de mensagens não persistentes |
|
| Contagem de mensagens não persistentes MQPUT1 |
|
| Não persistente - contagem de tópicos MQPUT/MQPUT1 |
|
| Navegação persistente de mensagens - contagem de bytes |
|
| Navegação persistente de mensagens - contagem |
|
| Obtenção destrutiva de mensagens persistentes - contagem |
|
| Contagem de MQPUT de mensagens persistentes |
|
| Contagem de mensagens persistentes MQPUT1 |
|
| Persistente - contagem de tópicos MQPUT/MQPUT1 |
|
| Publicado para assinantes - contagem de bytes |
|
| Publicado para assinantes – contagem de mensagens |
|
| Contagem de filas eliminadas |
|
| Coloque mensagens não persistentes - contagem de bytes |
|
| Coloque mensagens persistentes - contagem de bytes |
|
| Sistema de arquivos do Gerenciador de filas - espaço livre |
|
| Sistema de arquivos do Gerenciador de filas - bytes em uso |
|
| Porcentagem livre de RAM |
|
| Bytes totais de RAM |
|
| Total de bytes de RAM - estimativa para o gerenciador de filas |
|
| Retomar contagem de assinaturas duráveis |
|
| Contagem de reversão |
|
| Status do gerenciador de filas |
|
| Contagem de falhas de exclusão de assinatura |
|
| Tempo de CPU do sistema – estimativa percentual para o gerenciador de filas |
|
| Porcentagem de tempo de CPU do sistema |
|
| Total do intervalo MQPUT/MQPUT1 do tópico |
|
| Tempo de atividade |
|
| Tempo de CPU do usuário – estimativa percentual para o gerenciador de filas |
|
| Porcentagem de tempo de CPU do usuário |
|
| Mensagens recebidas |
|
| Tempo desde o recebimento da mensagem |
|
| Tipo de assinatura |
|
| Mensagens recebidas |
|
| Número de editores |
|
| Número de assinantes |
|
| Tempo desde a mensagem |
|
As seguintes métricas dimensionais são capturadas raspando o exportador e vinculadas à entidade IBMMQ_QUEUE
:
Nome | Descrição | Dimensões |
---|---|---|
| Profundidade máxima da fila |
|
| Uso da fila |
|
| tempo médio de fila |
|
| fila de bytes evitados |
|
| fila evitada coloca |
|
| Profundidade da fila |
|
| MQGET destrutivo falha |
|
| MQGET destrutivo falha com MQRC_NO_MSG_AVAILABLE |
|
| MQGET destrutivo falha com MQRC_TRUNCATED_MSG_FAILED |
|
| contagem de bytes não persistentes MQGET destrutiva |
|
| contagem de mensagens não persistentes MQGET destrutivas |
|
| contagem de bytes persistentes MQGET destrutiva |
|
| contagem de mensagens persistentes MQGET destrutivas |
|
| mensagens expiraram |
|
| Alças de entrada |
|
| contenção de bloqueio |
|
| Contagem MQCLOSE |
|
| A navegação MQGET falha |
|
| A navegação MQGET falha com MQRC_NO_MSG_AVAILABLE |
|
| A navegação MQGET falha com MQRC_TRUNCATED_MSG_FAILED |
|
| MQGET procura contagem de bytes não persistentes |
|
| MQGET procura contagem de mensagens não persistentes |
|
| MQGET procura contagem de bytes persistentes |
|
| MQGET procura contagem de mensagens persistentes |
|
| Contagem de bytes MQGET |
|
| Contagem MQGET |
|
| Contagem MQINQ |
|
| Contagem de MQOPEN |
|
| Contagem de bytes MQPUT |
|
| Contagem MQPUT/MQPUT1 |
|
| Contagem de mensagens não persistentes MQPUT |
|
| Contagem de mensagens persistentes MQPUT |
|
| Contagem de mensagens não persistentes MQPUT1 |
|
| Contagem de mensagens persistentes MQPUT1 |
|
| Contagem MQSET |
|
| contagem de bytes não persistentes |
|
| Mensagem mais antiga |
|
| Alças de entrada |
|
| contagem de bytes persistentes |
|
| contagem de fila eliminada |
|
| Tamanho atual do arquivo da fila |
|
| Tamanho máximo do arquivo da fila |
|
| Tempo de fila longo |
|
| Tempo de fila curto |
|
| contagem MQGET revertida |
|
| contagem MQPUT revertida |
|
| Tempo desde que foi obtido |
|
| Tempo desde a colocação |
|
| Mensagens não confirmadas (contagem) |
|
Verifique o código-fonte
Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias ou criar seu próprio fork e construí-lo.
Além disso, esta integração aproveita um exportador de código aberto criado pela comunidade.