Monitorando o IBM Db2

O sensor é compatível com o sistema operacional « IBM Db2 » 10.5 e versões posteriores.

A tabela a seguir mostra a versão mais recente compatível e a política de suporte:

Para obter mais informações sobre a política de suporte, consulte a estratégia de suporte para sensores.

O sensor não suporta o monitoramento de instâncias do Db2 com mecanismo de DATA_ENCRYPT segurança de autenticação.

Para essa tecnologia, o Instana oferece suporte ao rastreamento no lado do cliente para as seguintes linguagens e ambientes de execução:

• Java
• Node.js
• PHP
• .NET Framework
• .Net Core

Para usar uma porta customizada, banco de dados, usuário, senha, instância ou taxa de pesquisa, é necessário configurar os campos a seguir no arquivo de configuração do agente <agent_install_dir>/etc/instana/configuration.yaml:

Para que o agente do Instana se conecte com segurança ao seu servidor Db2, ele precisa ser configurado aqui <agent_install_dir>/etc/instana/configuration.yaml:

Instana oferece suporte à monitorização local para IBM Db2 em Red Hat OpenShift Container Platform. As instâncias do banco de dados do ` IBM Db2 ` no ambiente de contêineres são criadas como ` StatefulSets `. Eles são renderizados do mesmo modelo de pod usando Recursos Customizados (CR). O exemplo a seguir mostra uma configuração de exemplo para IBM Db2 :

com.instana.plugin.db2:
  local:
    - host: 'c-db2ucluster-sample-one-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases:
        - 'BLUDB'
    - host: 'c-db2ucluster-sample-two-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases: # multiple databases are supported
        - 'database1'
        - 'database2'
 

Se houver várias instâncias do ` IBM Db2 ` no mesmo nó de trabalho, é possível adicioná-las no mesmo arquivo de configuração.

O host URL dos serviços IBM Db2 é uma combinação do nome do serviço e do namespace no cluster OpenShift Container Platform no qual as instâncias do banco de dados são criadas. O arquivo ` URL ` geralmente tem o formato *serviceName*.*namespace*.svc. Por exemplo, se c-db2ucluster-sample-one é o nome do serviço e openshift-operators é o namespace, o host URL é c-db2ucluster-sample-one-db2u.openshift-operators.svc.

Se você recriar um pod, use o mesmo nome de serviço para preservar o histórico do banco de dados em Instana.

O tempo limite de login define o tempo máximo em segundos que o sensor aguarda para se conectar ao banco de dados. É possível definir um tempo limite de sessão no sensor Instana Db2 utilizando a loginTimeout propriedade no configuration.yaml arquivo. Se a conexão não for obtida dentro do intervalo loginTimeout especificado, um erro de conexão será exibido. O valor padrão para essa propriedade é 5 segundos. A propriedade é opcional e é aplicável para as configurações local e remota. O exemplo a seguir mostra como customizar a propriedadeloginTimeout :

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      loginTimeout: 20 #value in seconds
 

Você pode personalizar o intervalo de tempo para obter uma contagem das esperas por bloqueio e das consultas de longa duração no sensor Instana Db2 usando a lockAndLongQueryInterval propriedade no configuration.yaml arquivo. Por padrão, o tempo gasto pelo sensor para classificar uma consulta ou espera de bloqueio como longa execução é de 100 segundos. Essa métrica pode ser usada para configurações de alerta ou evento. A propriedade lockAndLongQueryInterval é opcional e é aplicável para as configurações local e remota. O exemplo a seguir mostra como customizar essa propriedade:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      lockAndLongQueryInterval: 60 # value in seconds
 

Agora é possível customizar o intervalo de tempo para coletar estatísticas de execução e métricas de reorganização. Para customizar seu intervalo de tempo, use a propriedade customRunStatsPollRate no arquivo configuration.yaml . Por padrão, as métricas são coletadas a cada 180 minutos. A propriedade customRunStatsPollRate é opcional e é aplicável para as configurações local e remota. O exemplo a seguir mostra como customizar essa propriedade:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      customRunStatsPollRate: 30 # value in minutes
 

Agora é possível customizar o número de linhas exibidas para tamanhos de tabela por esquema. Para customizar o número de linhas, use a propriedade tableSizeRowsLimit no arquivo configuration.yaml Por padrão, apenas as primeiras 50 tabelas por tamanho por esquema são exibidas A propriedade tableSizeRowsLimit é opcional e é aplicável para as configurações local e remota. O exemplo a seguir mostra como customizar essa propriedade:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      tableSizeRowsLimit: 100 # number of rows to fetch
 

JSON Os Web Tokens (JWT) são um mecanismo de autenticação compatível com Db2 e agora são suportados pelos sensores Db2 a partir da versão 1.0.27. Para fazer com que o agente do Instana suporte a conexão JWT ao seu servidor Db2, você precisa configurar o <agent_install_dir>/etc/instana/configuration.yaml arquivo da seguinte forma:

O monitoramento de várias instâncias é suportado para o monitoramento local e remoto. Aqui está um exemplo de como é possível configurá-lo dentro do arquivo configuration.yaml:

É possível monitorar a instância do Db2 pureScale localmente e remotamente. Os exemplos a seguir mostram como configurar o monitoramento local e remoto para uma instância do Db2 pureScale no arquivo configuration.yaml :

Você precisa conceder as seguintes permissões à conta de usuário Db2 utilizada pelo Instana :

GRANT DBADM ON DATABASE TO USER db2inst1;

ou

GRANT DATAACCESS ON DATABASE TO USER db2inst1;
GRANT SQLADM ON DATABASE TO USER db2inst1;
 

ou privilégio EXECUTE nas seguintes funções / visualizações ou procedimentos da tabela:

GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONTAINER TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TRANSACTION_LOG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_DATABASE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TABLESPACE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_PKG_CACHE_STMT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_AGENT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_HADR TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONNECTION TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UTILITY TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_WORKLOAD TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UNIT_OF_WORK TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_INSTANCE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_DIAG_HIST TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_LOG_MSGS TO USER db2inst1;
GRANT SELECT ON SYSIBMADM.MON_TRANSACTION_LOG_UTILIZATION TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.INDEXES TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.TABLES TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CURRENT_SQL TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DB_HISTORY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DBCFG TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CONNECTION_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_DB_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_LOCKWAITS TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.SNAP_REORG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DB_GET_CFG() TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DBM_GET_CFG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.ENV_GET_INST_INFO TO USER db2inst1;

SYSIBMADM.SNAP_REORG

GRANT SELECT ON TABLE SYSIBMADM.SNAPTAB_REORG TO USER db2inst1;

Exemplo:

db2 connect to db
 

db2 "grant dataaccess, sqladm on database to user db2inst1"
 

db2 "grant execute on FUNCTION SYSPROC.MON_GET_DATABASE to USER db2inst1"
 

Notas:

• Uma configuração de sondagem para um sensor LUW d IBM Db2 está ativada. Com esse recurso, é possível definir uma configuração customizada para buscar estatísticas em intervalos necessários e também desativar estatísticas irrelevantes.
• Se você estiver usando a configuração de pesquisa customizada, esta configuração terá prioridade sobre as configurações do sistema padrão.
• A customização de pesquisa é ativada apenas para as estatísticas que são descritas na tabela na seção Estatísticas Configuráveis As estatísticas para as quais a customização de pesquisa não está ativada são coletadas com menos freqüência e são vitais para o sistema Para obter mais informações sobre as estatísticas coletados e o intervalo de pesquisa padrão, consulte a seção Estatísticas Configuráveis ..
• Não é possível definir a configuração de intervalo menor que o valor padrão. Se você fizer uma configuração incorreta, essa entrada será movida para o próximo depósito de configuração de taxa de pesquisa mais alto que estiver disponível
• Se você omitir quaisquer estatísticas dos itens configuráveis (as estatísticas não são incluídas em nenhum dos depósitos poll_intervals ou disabled_metrics ), ele será incluído automaticamente no próximo depósito superior disponível. No entanto, se esse depósito não existir, ele será movido para a lista de métricas desativadas.
• Intervalos de pesquisa podem ser customizados para monitoramento local e remoto. Configure todos os intervalos de pesquisa em segundos
• Os nomes de estatísticas e os nomes de depósito (disabled_metrics, poll_rate_1, poll_rate_2, poll_rate_3e poll_rate_4) são fixos. É necessário nomeá-los conforme mostrado na tabela na seção Estatísticas de Configuração ou como na configuração de amostra a seguir:

Para customizar a pesquisa para monitoramento local e remoto, configure conforme a seguir:

      poll_rate: 5 # seconds
      custom_polling:
        disabled_metrics:
          metrics: DBM_CONFIG_STATS, AGENT_STATS #Stats that you don't want to be monitored
        poll_rate_1:
          poll_interval: 30
          metrics: TOP_QUERIES_STATS, TABLE_SPACE_STATS
        poll_rate_2:
          poll_interval: 200
          metrics: ELAPSED_TIME_STATS, WORKLOAD_STATS, TOP_TOTAL_STMT_IDS_STATS
        poll_rate_3:
          poll_interval: 900
          metrics: LOG_DISK_WAIT_STATS, DB_CONFIG_STATS, UNIT_OF_WORK_STATS
        poll_rate_4:
          poll_interval: 2000
          metrics: HADR_STATS, VMON_LOCK_STATS
      databases:
        - 'database1'
 

Você pode coletar métricas personalizadas além das métricas padrão usando as funções de tabela d DB2. Especifique as funções de tabela e as métricas que deseja coletar, e o sensor gera automaticamente as consultas SQL apropriadas com base na sua configuração e exporta todas as métricas no formato Prometheus.

Você pode definir a configuração de métricas personalizadas para o monitoramento local e remoto do IBM Db2 no arquivo de configuração do <agent_install_dir>/etc/instana/configuration.yaml agente da seguinte maneira:

• ID de Processo
• Porta
• Versão
• Horário de início/Tempo de atividade