Administração do agente do Instana no Red Hat OpenShift

Depois de instalar o agente, você pode verificar o status dos pods na implantação do agente usando os seguintes comandos:

kubectl get pods -n instana-agent
kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
 

Em uma boa implantação, o " STATUS de todos os pods no namespace deve ser " Running. O recurso personalizado ' instana-agent também deve exibir ' status: Running, conforme mostrado no exemplo a seguir:

$ kubectl get pods -n instana-agent
NAME                                      READY   STATUS    RESTARTS   AGE
controller-manager-6478cb4c6f-8s29b       1/1     Running   0          70m
instana-agent-8ftnj                       1/1     Running   0          70m
instana-agent-9w4vc                       1/1     Running   0          70m
instana-agent-k8sensor-5bbf568976-5pjk2   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-h96hr   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-lnbsg   1/1     Running   0          3h2m
instana-agent-zpmrj                       1/1     Running   0          70m

$ kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
conditions:
  - lastTransitionTime: "2024-08-06T08:12:03Z"
    message: most recent reconcile of agent CR completed without issue
    observedGeneration: 2

    ...

observedGeneration: 2
oldVersionsUpdated: true
operatorVersion: 0.0.1-dev
status: Running
 

Você pode configurar o agente do Instana para Kubernetes e Red Hat OpenShift de duas maneiras diferentes, dependendo do método utilizado para instalar o agente.

Dependendo do seu ambiente Red Hat OpenShift, talvez seja necessário personalizar o Container Registry Red Hat OpenShift.

Dependendo do método de instalação, é possível atualizar o agente do Instana para o Red Hat OpenShift de várias maneiras.

Você pode realizar as seguintes operações usando o painel de gerenciamento de agentes na interface do usuário do Instana :

• Alterando os modos do agente
• Alterar o nível de log
• Atualização de agentes
• Agentes de reajuste
• Reiniciando agentes
• Visualização de sensores
• [Gerenciamento de configuração]
  • Inicializando o Gerenciamento de configuração
  • Atualização do gerenciamento de configuração
• Automonitoramento

Para abrir o painel de controle do Agent Management, siga as etapas:

1. Na barra lateral da interface do usuário do Instana, selecione Infraestrutura.
2. Clique em um host monitorado específico.
3. No painel do host, clique em Abrir gerenciamento de agentes.

É necessário configurar o acesso à rede dos seguintes tipos de aplicativos para que eles possam se comunicar com o agente:

• Node.js
• Go
• Ruby
• Python
• .NET Core

Essas aplicações precisam saber o endereço IP no qual o agente está escutando. O agente escuta o IP do host automaticamente. Você pode usar o seguinte trecho de código do Downward API para passar o IP do host, contido em uma variável de ambiente, para o pod da aplicação:

spec:
  containers:
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP
 

Por padrão, o agente do host não é agendado nos nós do plano de control Kubernetes. Para obter informações sobre como monitorar nós do plano de controle, consulte a seção Monitoramento de nós do plano de controle.

Para um controle mais direto, instale o agente separadamente nos nós do plano de controle.

Para obter orientações sobre como configurar o Ingress do Kubernetes NGINX e nosso agente para capturar métricas do NGINX, consulte a página de monitoramento NGINX. O rastreamento do Ingress do Kubernetes NGINX também é possível por meio do projeto OpenTracing; consulte Rastreamento Distribuído para o Ingress do NGINX para obter orientações sobre como configurá-lo.

Para adicionar back-ends adicionais usando o ` helm ` e o operador, execute o seguinte comando. Você pode usar back-ends adicionais para configurar seu agente Instana ou deixar esse campo em branco.

• Como usar o site helm :

     helm install instana-agent \
     --repo https://agents.instana.io/helm \
     --namespace instana-agent \
     --create-namespace \
     --set agent.key=my-key \
     --set agent.endpointHost='<your_host_agent_endpoint>' \
     --set agent.endpointPort=443 \
     --set cluster.name='<your_cluster_name>' \
     --set zone.name='zone-name' \
     --set "agent.additionalBackends[0].endpointHost=<your_host_agent_endpoint>" \
     --set "agent.additionalBackends[0].key=<your_agent_key>" \
     --set "agent.additionalBackends[0].endpointPort=443" \
     --set "agent.additionalBackends[1].endpointHost=<your_other_host_agent_endpoint>" \
     --set "agent.additionalBackends[1].key=<your_other_agent_key>" \
     --set "agent.additionalBackends[1].endpointPort=443" \
     instana-agent
   

• Usando o operador:

  apiVersion: instana.io/v1
  kind: InstanaAgent
  metadata:
    name: instana-agent
    namespace: instana-agent
  spec:
    zone:
      name: edited-zone # (optional) name of the zone of the host
    cluster:
      name: my-cluster
    agent:
      endpointHost: <your_host_agent_endpoint>
      endpointPort: "443"
      env: {}
      key: <your_agent_key>
      additionalBackends:
      - endpointHost: <your_host_agent_endpoint>
        endpointPort: "443"
        key: <your_agent_key>
      configuration_yaml: |
        # You can leave this empty, or use this to configure your instana agent.
        # See https://github.com/instana/instana-agent-operator/blob/main/config/samples/instana_v1_extended_instanaagent.yaml for the extended version.
  
   

Para habilitar o envio de relatórios para vários back-ends a partir de um agente do Kubernetes, consulte a configuração do agente em Docker.

Você pode usar os Secrets para armazenar e gerenciar dados confidenciais, como credenciais, tokens ou chaves. Consulte Kubernetes secrets para obter mais detalhes.