O Kmind Client pode ser instalado diretamente em um cluster Kubernetes utilizando o Helm, facilitando a configuração e integração com os serviços de métricas, logs e monitoramento.

Este guia descreve como instalar e configurar o agente utilizando nosso Helm Chart oficial.

✅ Pré-requisitos #

Antes de iniciar, verifique se você possui:

• Kubectl configurado para acessar o cluster.
• Helm instalado (versão 3 ou superior).
• Permissão para criar namespaces, ConfigMaps, Deployments, Services e Custom Resources.
• Token e nome do cluster fornecidos pelo time do Kmind.
• Tenant ID associado à sua conta.

1 – Adicionar o repositório Helm do Kmind

helm repo add kmind https://charts.kmind.com.br
helm repo update

2 – Criar um arquivo values.yaml

Você precisará criar um arquivo values.yaml com as informações do seu tenant, cluster e tokens.

kmind:
  tenant:
    name: "TENANT_NAME"
  cluster:
    name: "CLUSTER_NAME"
    token: "CLUSTER_TOKEN"

promtail:
  tolerations:
    - operator: Exists
      effect: NoSchedule
  config:
    clients:
      - url: "https://log.kmind.com.br/loki/api/v1/push"
        tenant_id: "TENANT_ID"
        headers:
          X-Scope-OrgID: "TENANT_ID"
  extraArgs:
    - "-client.external-labels=tenant=TENANT_NAME,cluster=CLUSTER_NAME"

victoria-metrics-agent:
  remoteWrite:
    - url: "https://metrics.kmind.com.br/insert/TENANT_ID/prometheus/api/v1/write"
      label: tenant=TENANT_NAME,cluster=CLUSTER_NAME

Importante

• Substitua TENANT_ID, TENANT_NAME, CLUSTER_NAME e CLUSTER_TOKEN pelos valores fornecidos pela equipe Kmind.
• Não altere a estrutura de indentação do YAML.

3 – Instalar o agente no cluster

Com o values.yaml configurado, execute o comando abaixo para instalar:

helm install kmind-client kmind/kmind-client -f values.yaml --namespace kmind --create-namespace

4 – Validar a instalação

Verifique se todos os pods estão rodando corretamente:

kubectl get pods -n kmind

Você deverá ver algo como:

NAME                                         READY   STATUS    RESTARTS   AGE
kmind-client-5d7f8b8b9f-abc12                1/1     Running   0          1m
kmind-client-victoria-metrics-agent-xxxxx    1/1     Running   0          1m
kmind-client-promtail-xxxxx                  1/1     Running   0          1m

5 – Atualizar a configuração

Se for necessário alterar alguma configuração, basta editar o values.yaml e aplicar:

helm upgrade kmind-client kmind/kmind-client -f values.yaml -n kmind

6 – Remover o agente

Caso precise remover:

helm uninstall kmind-client -n kmind

⚙️ Configuração das variáveis de ambiente #

⚠️ Observações importantes #

• Esse chart já instala e configura automaticamente:
  • victoria-metrics-agent para métricas do cluster.
  • promtail para coleta de logs.
  • kube-state-metrics e node-exporter para informações de recursos.
• Todas as integrações são feitas com autenticação via tokens e labels de tenant/cluster.
• A configuração padrão já é suficiente para ambientes de produção, bastando apenas ajustar os identificadores do cliente.