Monitoramento do IBM MQ Appliance com OpenTelemetry

Editar online

IBM MQ Appliance é um produto de hardware que inclui um IBM MQ e instalado e pronto para uso. Instana utiliza um coletor de dados OpenTelemetry para monitorar um host IBM MQ Appliance.

Certifique-se de que o SDK do Java, versão 11 ou posterior, esteja instalado.

Para verificar a versão do SDK do Java :

java -version

Para configurar o coletor de dados OpenTelemetry IBM MQ Appliance, conclua as etapas a seguir:

  1. Baixe os drivers mais recentes do Data Collector do OpenTelemetry (ODCD) em OpenTelemetry Data Collector Drivers Release
    Figura 1. Abre em uma nova guia ou janela
    Ícone de link externo
    .

  2. Extraia o pacote para um local de implementação.

    tar vxf otel-dc-host-0.2.3.tar
cd otel-dc-host-0.2.3

  3. Na pasta extraída, certifique-se de que os seguintes arquivos de configuração estejam atualizados para se adequar ao seu ambiente:

    • config/config.yaml
    • config/logging.properties

  4. Atualize o arquivo de configuração ' config/config.yaml para o IBM MQ Appliance. O arquivo de configuração padrão é " config/config.yaml.

  5. Conclua uma das etapas a seguir:

    • Copie o arquivo config/config-mqappliance.yaml para config/config.yaml.

    • Use a variável de ambiente ' DC_CONFIG para especificar o arquivo de configuração, por exemplo:

      export DC_CONFIG=config/config-mqappliance.yaml

arquivo de configuração de amostra

Editar online

Um arquivo de configuração de exemplo compartilhado no arquivo para monitorar as métricas do IBM MQ Appliance no Instana, conforme mostrado no trecho a seguir:

host.system: mq_appliance
instances:
  - appliance.host: testbox1.mqappliance.com
    appliance.user: admin
    appliance.password: xxxxxxxx
    #Data collector properties:
    poll.interval: 10
    callback.interval: 5
    otel.backend.url: http://127.0.0.1:4317
    #otel.backend.using.http: true

Execute o Data Collector com o seguinte comando, de acordo com seu sistema atual:

nohup ./bin/otel-dc-host

Os parâmetros a seguir são usados no arquivo de configuração dos coletores de dados do host.

Parâmetro Escopo Descrição Valores de exemplo
appliance.host mq_appliance O nome do host do IBM MQ Appliance testbox1.mqappliance.com
appliance.user mq_appliance O nome de usuário do IBM MQ Appliance administrador
appliance.password mq_appliance A senha do IBM MQ Appliance password1

Para visualizar métricas na interface do usuário do Instana, clique em Infraestrutura. IBM MQ Appliance é exibido como OTEL Host. Selecione IBM MQ Appliance e clique em Abrir painel.

Figura 2. OpenTelemetry métricas
Entidade OpenTelemetry