Integração com o IBM Turbonomic

Você pode integrar o IBM® Instana Observability com o IBM® Turbonomic para que o Turbonomic possa identificar e otimizar as entidades que o Instana gerencia em seu ambiente. Após a integração, você também poderá revisar e executar ações do Turbonomic a partir da interface do usuário (UI) do Instana.

Antes de iniciar

Observação: As instruções a seguir descrevem as etapas manuais para a integração com o Turbonomic. Essas etapas se aplicam a todas as instâncias auto-hospedadas do Instana e a algumas instâncias do SaaS. Em instâncias do SaaS do Instana que tenham uma instância do Turbonomic SaaS na mesma conta, os administradores podem ativar automaticamente a integração do Turbonomic sem necessidade de configuração manual. Para obter mais informações, consulte Integração automatizada com o IBM Turbonomic.

Certifique-se de que cumpre os seguintes pré-requisitos:

  • Instana e licenças Standard do Turbonomic ( SaaS ou auto-hospedadas) com um mínimo de 200 contas gerenciadas do Virtual Servers ( MVS ).
  • Turbonomic versão 8.13.6 ou posterior:
    • Antes de realizar a integração, é necessário configurar um destino do ` Instana ` em Turbonomic. Para obter mais informações, consulte Instana na documentação do Turbonomic.
    • Se a infraestrutura subjacente às suas aplicações gerenciadas pelo Instana for executada em Kubernetes ou Red Hat OpenShift, certifique-se de que a sonda Kubeturbo Turbonomic esteja implantada.
    • No Turbonomic, você precisa ter a função de administrador, administrador do site ou automatizador para configurar essa integração. Para obter mais informações, consulte Gerenciamento de contas de usuário na documentação do Turbonomic.
  • Instana versão 242 ou posterior:
    • É necessário instalar um agente de host do Instana para coletar dados em seu ambiente. Para essa integração, o agente host não requer privilégios de root, e a prática recomendada é instalá-lo como um usuário sem privilégios de root. Como alternativa, se você estiver instalando o agente no cluster do Kubernetes, pode usar o agente remoto Instana, que é otimizado para monitoramento remoto.
    • Para executar ações de automação do Turbonomic a partir da interface do usuário do Instana após a conclusão da integração, é necessário ter permissões para a execução de ações de automação do Instana. Para obter mais informações, consulte Gerenciamento do acesso de usuários.
    • Para uma instância auto-hospedada do Instana, é necessário ativar o sinalizador de recurso para a estrutura de automação. Para obter mais informações, consulte Gerenciamento de ações.
    • A Edição Clássica do Instana não é compatível, pois não oferece os componentes necessários para essa integração.

Sobre essa tarefa

Turbonomic utiliza o destino configurado do ` Instana ` para coletar dados sobre os aplicativos gerenciados pelo ` Instana ` e inclui as informações detectadas em seus cálculos para ações relacionadas a recursos. Ao ativar o sensor " Turbonomic " na sua instância do Instana, você poderá gerenciar essas ações a partir da interface do usuário do Instana. Este sensor consulta as APIs do Turbonomic a cada 10 minutos para recuperar informações sobre as ações executadas e recomendadas no Turbonomic.

Essas ações ajudam a otimizar as seguintes entidades:

  • Aplicativos
  • Serviços
  • Terminais
  • Máquinas virtuais
  • Contêineres
  • Java máquinas virtuais (JVMs)
  • Servidores de banco de dados
  • Kubernetes controladores de carga de trabalho e namespaces

Configurando o sensor do Turbonomic

No ` Instana `, configure o sensor ` Turbonomic `. Atualize o arquivo de configuração do agente ( instana-agent-dir/etc/instana/configuration.yaml ), conforme mostrado no exemplo a seguir. Substitua os parênteses (< >) e o conteúdo entre eles pelos valores específicos das suas instâncias Instana e Turbonomic :

# Turbonomic sensor
com.instana.plugin.turbonomic:
 enabled: true
 host: '<Turbonomic server host or IP address in https://x.x.x.x format>'
 target: '<Hostname or IP address of the Instana target as configured in Turbonomic>'
 auth:
  username: <Your Turbonomic username>
  password: <Your Turbonomic user password>
Observação: O valor de target deve corresponder exatamente ao campo “Nome do host” ou “Endereço IP” na configuração do destino do Turbonomic.

Turbonomic OAuth 2.0 atendimento ao cliente

O sensor pode ser configurado para utilizar um cliente existente do Turbonomic OAuth. Você pode criar clientes d OAuth em Turbonomic utilizando as APIs documentadas em Turbonomic.

# Turbonomic sensor
com.instana.plugin.turbonomic:
 enabled: true
 host: '<Turbonomic server host or IP address in https://x.x.x.x format>'
 target: '<Hostname or IP address of the Instana target as configured in Turbonomic>'
 auth:
  authType: oauth
  clientId: '<The client id for this oauth client>'
  clientSecret: '<The client secret for this oauth client>'
  clientRole: '<The Turbonomic user role for this oauth client>'

clientId e clientSecret são parâmetros obrigatórios. Se não clientRole for especificado, o valor padrão é SITE_ADMIN.

Configure apenas um agente de host do Instana com este sensor por instância do Turbonomic. Um único sensor coleta todos os dados de ação d Turbonomic es do seu ambiente. Em ambientes do ` Kubernetes `, instale o agente do ` Instana ` separadamente em uma máquina dedicada para garantir que apenas um agente monitore as entidades do ` Turbonomic `.

Resultados

Suas instâncias do Turbonomic e do Instana agora estão integradas. Turbonomic pode recomendar e executar ações para otimizar os recursos que dão suporte às suas aplicações gerenciadas pelo Instana. Você pode consultar as ações recomendadas e executadas do Turbonomic na interface do usuário do Instana.

Resolução de problemas do sensor de pressão do ar do motor ( Turbonomic )

Por padrão, o sensor Turbonomic valida o certificado do servidor Turbonomic. No entanto, se a sua instância do Turbonomic usar um certificado autoassinado, a validação falhará com uma exceção semelhante ao exemplo a seguir:

turbonomic_sensor_exception : Auth API Exception [PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target]

Para resolver esse erro, você pode ignorar a validação do certificado definindo a ignoreCertErrors propriedade na configuração do sensor, conforme mostrado no exemplo a seguir:

# Turbonomic sensor
com.instana.plugin.turbonomic:
 enabled: true
 ignoreCertErrors: true
 host: '<Turbonomic server host or IP address in https://x.x.x.x format>'
 target: '<Hostname or IP address of the Instana target as configured in Turbonomic>'
 auth:
  username: <Your Turbonomic username>
  password: <Your Turbonomic user password>