Instalação manual do suporte do Stackdriver

Instruções para instalação

As seções a seguir explicam como instalar manualmente o Stackdriver Kubernetes Monitoring em um cluster novo ou atual e incluem algumas informações sobre como o Stackdriver Kubernetes Monitoring é implementado.

Resumo

  • Use o comando gcloud beta container para criar seu cluster. Não instale o suporte do Stackdriver. Use o Kubernetes 1.10.6 ou 1.11.2 (ou posterior, se disponível).

  • Use a kubectl para configurar o Stackdriver Kubernetes Monitoring, conforme mostrado abaixo.

Criar um cluster

  1. Abra uma janela de terminal com o SDK do Cloud e a kubectl instalados. Uma maneira fácil de fazer isso é usar o Cloud Shell:

    1. Acesse a página de Clusters do Kubernetes do projeto:

      ACESSAR CLUSTERS DO KUBERNETES

    2. Clique no ícone Activate Cloud Shell na parte superior da página.

  2. Crie seu cluster do Kubernetes Engine usando o seguinte comando da gcloud. Não instale nenhum suporte de registro ou monitoramento:

    gcloud beta container clusters create [CLUSTER_NAME] \
      --zone=[ZONE] \
      --project=[PROJECT_ID] \
      --cluster-version=1.10 \
      --no-enable-cloud-logging \
      --no-enable-cloud-monitoring
    

    Para ver informações sobre outras sinalizações e opções que você queira usar no cluster, consulte Como criar um cluster.

Como instalar o Kubernetes Monitoring

  1. Conecte-se ao cluster usando o seguinte comando:

    gcloud container clusters get-credentials [CLUSTER_ID] --zone [ZONE] --project [PROJECT_ID]
    
  2. Configure o Stackdriver Kubernetes Monitoring usando os seguintes comandos:

    kubectl apply -f https://raw.githubusercontent.com/Stackdriver/kubernetes-configs/stable/rbac-setup.yaml \
      --as=admin --as-group=system:masters
    
    kubectl apply -f https://raw.githubusercontent.com/Stackdriver/kubernetes-configs/stable/agents.yaml
    

Para ver mais informações sobre os scripts de configuração acima, consulte Arquivos de configuração nesta página.

Como validar a instalação

Para garantir que o Stackdriver Kubernetes Monitoring seja executado corretamente, aguarde alguns minutos e examine o cluster com o seguinte comando:

kubectl get pods --all-namespaces

Aparecerão pods com os seguintes nomes (entre outros):

  • stackdriver-logging-agent-...: o agente do Stackdriver Logging
  • heapster-...: o agente do Monitoring
  • stackdriver-metadata-agent-...: o agente de metadados do Stackdriver

Como remover instalações manuais

Para desinstalar uma instalação manual, execute o seguinte comando no cluster:

kubectl delete namespace stackdriver-agents

Essa etapa é necessária antes de voltar a usar o suporte gerenciado recomendado do Stackdriver Kubernetes Monitoring. Para mais informações, consulte Como fazer upgrade de um cluster existente.

Próximas etapas

Observações sobre implementação

As informações nesta seção são opcionais.

O Stackdriver Kubernetes Monitoring é implementado por três agentes do Stackdriver:

  • O agente de metadados do Stackdriver (stackdriver-metadata-agent-...) registra o conjunto atual de nós, contêineres, pods etc.
  • O agente do Stackdriver Logging (stackdriver-logging-agent-...) envia entradas de registro para o Stackdriver Logging.
  • O agente do Stackdriver Monitoring (heapster...) envia dados de métrica para o Stackdriver Monitoring. Isso inclui métricas do Prometheus.

Os agentes são executados em um destes dois namespaces:

  • stackdriver-agents, quando instalados manualmente usando os scripts desta página
  • kube-system, quando instalados pelo console do Kubernetes Engine ou quando instalados com a gcloud usando a opção --enable-stackdriver-kubernetes

O diagrama a seguir mostra como esses agentes são organizados.

Arquitetura do Kubernetes Monitoring

Arquivos de configuração

Os arquivos de configuração usados para instalar o Stackdriver Kubernetes Monitoring são descritos abaixo:

Tipos de recursos monitorados

O Stackdriver rotula cada entrada de registro e dado de métrica com um recurso monitorado que identifica a origem das informações. Os tipos de recursos associados ao Stackdriver Kubernetes Monitoring para monitoramento e registro estão listados abaixo:

Esses tipos não são iguais aos usados pelo antigo suporte do Stackdriver. Para ver informações sobre essa incompatibilidade e como migrar o cluster atual, consulte Como migrar para o Stackdriver Kubernetes Monitoring.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.