Antes de Iniciar

• Certifique-se de que você tenha acesso ao cluster Kubernetes com permissões para criar namespaces e implantar o agente.

• Faça uma cópia do mapa de configuração atual do agente de registro. Execute: kubectl get cm logs-agent -n ibm-observe -o yaml > logging-agent-backup-cm.yaml

• Instale as CLIs a seguir:

  • A IBM Cloud CLI para fazer login no IBM Cloud e gerenciar os serviços IBM Cloud, como a criação de uma chave de API.

  • A CLI Kubernetes para gerenciar clusters Kubernetes usando os comandos kubectl. Saiba mais.

  • A CLI do Openshift para gerenciar clusters do OpenShift a partir da linha de comando. Saiba mais.

• Leia sobre o Agente de criação de log.

• Verifique as versões do agente que estão disponíveis. Para obter mais informações, consulte Verificação das versões disponíveis do agente. Observe que a versão do gráfico Helm corresponderá à versão do agente - por exemplo, se você estiver usando a versão 1.3.0 do agente, haverá um gráfico Helm com a versão 1.3.0 que acompanha essa versão.

Etapa 1. Atualize o arquivo de valores do gráfico do Helm para o Agente de criação de log

Conclua as etapas a seguir para modificar o gráfico Helm com a versão do agente que você planeja implantar:

1. Atualize o arquivo chamado logs-values.yaml que você usou para implantar o agente com o seguinte conteúdo:

   O arquivo logs-values.yaml contém as configurações específicas de sua implementação.

   Se você não tiver o arquivo logs-values.yaml que usou para implantar o agente, crie um com base na configuração atual do configmap do agente.

   metadata:
     name: "logs-agent"
   image:
     version: "1.6.1"  # Modify the agent version and enter the version that you want to deploy
   
   clusterName: "ENTER_CLUSTER_NAME"     # Enter the name of your cluster. This information is used to improve the metadata and help with your filtering.
   
   additionalMetadata: # add additional metadata, for example:
     region: au-syd
     env: production
     logs-agent-version: 1.6.1     # Enter the agent version that you want to deploy
   
   env:
     # ingestionHost is a required field. For example:
     # ingestionHost: "<logs instance>.ingress.us-east.logs.cloud.ibm.com"
     ingestionHost: "" # required
   
     # If you are using private CSE proxy, then use port number "3443"
     # If you are using private VPE Gateway, then use port number "443"
     # If you are using the public endpoint, then use port number "443"
     ingestionPort: "" # required
   
     iamMode: "TrustedProfile"
     # trustedProfileID - trusted profile id - required for iam trusted profile mode
     trustedProfileID: "" # required if iamMode is set to TrustedProfile
   
   

Etapa 2. Atualizar o agente

Se você estiver usando o " iamMode como " IAMAPIKey, a apikey precisará estar presente em um segredo Kubernetes chamado " logs-agent com o nome da chave " IAM_API_KEY. O segredo pode ser criado usando o Helm chart, incluindo a opção " --set secret.iamAPIKey=<your iamAPIKey> ao executar a instalação do helm. Se o segredo tiver sido criado manualmente ou se você estiver usando " iamMode=TrustedProfile, não inclua essa opção.

Conclua as etapas a seguir:

1. Efetue login no cluster. Para obter mais informações, consulte Acessar seu cluster.

2. Atualize o agente.

   Se você tiver instalado uma versão anterior do Agente de criação de log e tiver atualizado a configuração do agente modificando o mapa de configuração diretamente no cluster, faça uma cópia do mapa de configuração do cluster antes de executar o comando helm upgrade. Quando o site Agente de criação de log for atualizado, todas as alterações feitas no mapa de configuração serão substituídas.

   Se você estiver usando ' iamMode=TrustedProfile, o comando completo será:

   helm upgrade <install-name> oci://icr.io/ibm-observe/logs-agent-helm --version <chart-version> --values <PATH>/logs-values.yaml -n ibm-observe
   

   Se você estiver usando ' iamMode=IAMAPIKey, o comando completo será:

   helm upgrade <install-name> oci://icr.io/ibm-observe/logs-agent-helm --version <chart-version> --values <PATH>/logs-values.yaml -n ibm-observe --set secret.iamAPIKey=<APIKey-value>
   

   em que:

   • <install-name> é o nome da instalação Helm (logs-agent). Você pode executar o seguinte comando para obter o nome da instalação: helm list -n ibm-observe
   • <chart-version> é a versão do gráfico do leme. A versão do gráfico Helm deve corresponder à versão da imagem do agente. Para obter mais informações, consulte ' versões do gráfico Helm.
   • <PATH> é o caminho do diretório em que o arquivo ' logs-values.yaml está localizado.
   • <APIKey-value> é a apikey do IAM associada ao ServiceID.

   Por exemplo, você pode executar o seguinte comando no diretório em que o arquivo " logs-values.yaml está disponível:

   helm upgrade logs-agent oci://icr.io/ibm-observe/logs-agent-helm --version 1.5.0 --values ./logs-values.yaml -n ibm-observe --set secret.iamAPIKey=<secret>
   

   Para ver o nome do agente instalado e a versão do gráfico, você pode executar helm list -n NAMESPACE.

3. Reinicie os pods de agente.

   Para clusters Kubernetes, execute:

   kubectl -n ibm-observe rollout restart ds/logs-agent
   

   Para clusters OpenShift, execute:

   oc -n ibm-observe rollout restart ds/logs-agent
   

4. Verifique se todos os pods foram reiniciados, se estão no status running e se não estão relatando erros.

   Para clusters Kubernetes, execute:

   kubectl get pods -n ibm-observe
   

   Para clusters OpenShift, execute:

   oc get pods -n ibm-observe
   

Etapa 3. Verificar se os registros estão sendo entregues ao seu destino de destino

Conclua as etapas a seguir:

1. Acesse a interface do usuário da Web para sua instância IBM Cloud Logs.

2. Quando o agente estiver configurado corretamente, você poderá ver os registros por meio da visualização padrão do painel. O Agente de criação de log marca os registros de log com um objeto kubernetes que inclui o nome do cluster.

   kubernetes.cluster_name:<CLUSTER_NAME>
   

   Você pode executar a consulta ' kubernetes.cluster_name:<YOUR_CLUSTER_NAME> em sua instância IBM Cloud Logs para pesquisar os logs gerados pelo seu cluster.