Skip to main content
Data Infrastructure Insights
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Configurando um agente para coletar dados (Windows/Linux)

Colaboradores netapp-alavoie dgracenetapp netapp-mjryan
PDFs

O Data Infrastructure Insights usa "Telegraf" como seu agente para a coleta de dados de integração. Telegraf é um agente de servidor baseado em plugins que pode ser usado para coletar e relatar métricas, eventos e logs. Plugins de entrada são usados para coletar as informações desejadas no agente acessando o sistema/os diretamente, chamando APIs de terceiros ou ouvindo fluxos configurados (ou seja, Kafka, statsD, etc). Os plugins de saída são usados para enviar as métricas, eventos e logs coletados do agente para o Data Infrastructure Insights.

Para obter informações sobre como instalar no Kubernetes, consulte a "Operador de monitoramento do Kubernetes do NetApp"página.

Observação Para uma auditoria precisa e relatórios de dados, é altamente recomendável sincronizar a hora na máquina do agente usando Network Time Protocol (NTP) ou Simple Network Time Protocol (SNTP).
Observação Se você quiser verificar os arquivos de instalação antes de instalar o Agente, consulte a seção abaixo em Verificando somas de verificação do pacote Telegraf.

Instalando um agente

Se você estiver instalando um coletor de dados de serviço e ainda não tiver configurado um agente, será solicitado que você instale primeiro um agente para o sistema operacional apropriado. Este tópico fornece instruções para instalar o agente Telegraf nos seguintes sistemas operacionais:

Para instalar um agente, independentemente da plataforma que você estiver usando, primeiro faça o seguinte:

  1. Faça login no host que você usará para seu agente.

  2. Faça login no seu ambiente Data Infrastructure Insights e navegue até Observability > Collectors.

  3. Clique em * Data Collector* e escolha um coletor de dados para instalar.

  4. Escolha a plataforma apropriada para o seu host (Windows, Linux)

  5. Siga as etapas restantes para cada plataforma.

Observação Depois de instalar um agente em um host, você não precisa instalar um agente novamente nesse host.
Dica Depois de instalar um agente em um servidor/VM, o Data Infrastructure Insights coleta métricas desse sistema, além de coletar de qualquer coletor de dados que você configurar. Essas métricas são reunidas como "Métricas de "nó"".
Observação Se você estiver usando um proxy, leia as instruções de proxy da sua plataforma antes de instalar o agente Telegraf.

Locais de registo

As mensagens de log do Telegraf são redirecionadas do stdout para os seguintes arquivos de log são padrão:

  • RHEL/CentOS: /Var/log/telegraf/telegraf.log

  • Ubuntu/Debian: /Var/log/telegraf/telegraf.log

  • Windows: C: Arquivos de programas / telegraf / telegraf.log

Windows

Pré-requisitos:

  • O PowerShell deve ser instalado

  • Se você estiver atrás de um proxy, siga as instruções na seção Configurando o suporte Proxy para Windows.

Configurando o suporte Proxy para Windows

Observação Se o seu ambiente usar um proxy, leia esta seção antes de instalar.
Observação As etapas abaixo descrevem as ações necessárias para definir as variáveis de ambiente http_proxy/https_proxy. Para alguns ambientes proxy, os usuários também podem precisar definir a variável no_proxy environment.

Para sistemas que residem atrás de um proxy, execute o seguinte para definir a(s) variável(s) de ambiente https_proxy e/ou http_proxy ANTES para instalar o agente Telegraf:

[System.Environment]:SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]:Machine)

Instalando o agente

Instalação do Windows Agent

Etapas para instalar o agente no Windows:

  1. Escolha uma chave de acesso ao agente.

  2. Copie o bloco de comandos da caixa de diálogo de instalação do agente. Você pode clicar no ícone da área de transferência para copiar rapidamente o comando para a área de transferência.

  3. Abra uma janela do PowerShell

  4. Cole o comando na janela do PowerShell e pressione Enter.

  5. O comando fará o download do instalador do agente apropriado, instalá-lo e definirá uma configuração padrão. Quando terminar, ele reiniciará o serviço do agente. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Finish ou Continue

Depois que o agente estiver instalado, você poderá usar os seguintes comandos para iniciar/parar o serviço:

Start-Service telegraf
Stop-Service telegraf

Desinstalar o agente

Para desinstalar o agente no Windows, faça o seguinte em uma janela do PowerShell:

  1. Parar e eliminar o serviço Telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Remova o certificado da trustore:

    cd Cert:\CurrentUser\Root
//rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC
rm 1A918038E8E127BB5C87A202DF173B97A05B4996

  3. Exclua a pasta C: /Program Files/telegraf para remover os arquivos binários, logs e configurações

  4. Remova a chave SYSTEM_CurrentControlSet/Services/EventLog/Application/telegraf do Registro

Atualizando o agente

Para atualizar o agente telegraf, faça o seguinte:

  1. Parar e eliminar o serviço telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Exclua a chave SYSTEM_CurrentControlSet/Services/EventLog/Application/telegraf do Registro

  3. Excluir arquivos _C

  4. Excluir arquivos _C

  5. "Instale o novo agente".

RHEL e CentOS

Pré-requisitos:

  • Os seguintes comandos devem estar disponíveis: Curl, sudo, ping, sha256sum, openssl e dmidecode

  • Se você estiver atrás de um proxy, siga as instruções na seção Configurando o suporte Proxy para RHEL/CentOS.

Configurando o suporte de proxy para RHEL/CentOS

Observação Se o seu ambiente usar um proxy, leia esta seção antes de instalar.
Observação As etapas abaixo descrevem as ações necessárias para definir as variáveis de ambiente http_proxy/https_proxy. Para alguns ambientes proxy, os usuários também podem precisar definir a variável no_proxy environment.

Para sistemas que residem atrás de um proxy, execute as seguintes etapas ANTES para instalar o agente Telegraf:

  1. Defina a(s) variável(s) de ambiente https_proxy e/ou http_proxy para o usuário atual:

     export https_proxy=<proxy_server>:<proxy_port>
. Crie _/etc/default/telegraf_ e insira definições para as variáveis _https_proxy_ e/ou _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Instalando o agente

Instalação do agente RHEL/CentOS

Etapas para instalar o agente no RHEL/CentOS:

  1. Escolha uma chave de acesso ao agente.

  2. Copie o bloco de comandos da caixa de diálogo de instalação do agente. Você pode clicar no ícone da área de transferência para copiar rapidamente o comando para a área de transferência.

  3. Abra uma janela Bash

  4. Cole o comando na janela Bash e pressione Enter.

  5. O comando fará o download do instalador do agente apropriado, instalá-lo e definirá uma configuração padrão. Quando terminar, ele reiniciará o serviço do agente. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Finish ou Continue

Depois que o agente estiver instalado, você poderá usar os seguintes comandos para iniciar/parar o serviço:

Se o sistema operacional estiver usando systemd (CentOS 7 e RHEL 7):

sudo systemctl start telegraf
sudo systemctl stop telegraf

Se o sistema operacional não estiver usando systemd (CentOS 7 e RHEL 7):

sudo service telegraf start
sudo service telegraf stop

Desinstalar o agente

Para desinstalar o agente no RHEL/CentOS, em um terminal Bash, faça o seguinte:

  1. Pare o serviço Telegraf:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Remova o agente Telegraf:

     yum remove telegraf
. Remova qualquer configuração ou arquivos de log que possam ser deixados para trás:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Atualizando o agente

Para atualizar o agente telegraf, faça o seguinte:

  1. Pare o serviço telegraf:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Remova o agente telegraf anterior:

     yum remove telegraf
. link:#rhel-and-centos["Instale o novo agente"].

Ubuntu e Debian

Pré-requisitos:

  • Os seguintes comandos devem estar disponíveis: Curl, sudo, ping, sha256sum, openssl e dmidecode

  • Se você está atrás de um proxy, você deve seguir as instruções na seção Configurando o suporte Proxy para Ubuntu/Debian.

Configurando o suporte Proxy para Ubuntu/Debian

Observação Se o seu ambiente usar um proxy, leia esta seção antes de instalar.
Observação As etapas abaixo descrevem as ações necessárias para definir as variáveis de ambiente http_proxy/https_proxy. Para alguns ambientes proxy, os usuários também podem precisar definir a variável no_proxy environment.

Para sistemas que residem atrás de um proxy, execute as seguintes etapas ANTES para instalar o agente Telegraf:

  1. Defina a(s) variável(s) de ambiente https_proxy e/ou http_proxy para o usuário atual:

     export https_proxy=<proxy_server>:<proxy_port>
. Crie /etc/default/telegraf e insira definições para as variáveis _https_proxy_ e/ou _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Instalando o agente

Instalação do Agente Ubuntu/Debian

Passos para instalar o agente no Debian ou Ubuntu:

  1. Escolha uma chave de acesso ao agente.

  2. Copie o bloco de comandos da caixa de diálogo de instalação do agente. Você pode clicar no ícone da área de transferência para copiar rapidamente o comando para a área de transferência.

  3. Abra uma janela Bash

  4. Cole o comando na janela Bash e pressione Enter.

  5. O comando fará o download do instalador do agente apropriado, instalá-lo e definirá uma configuração padrão. Quando terminar, ele reiniciará o serviço do agente. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Finish ou Continue

Depois que o agente estiver instalado, você poderá usar os seguintes comandos para iniciar/parar o serviço:

Se o seu sistema operacional estiver usando systemd:

sudo systemctl start telegraf
sudo systemctl stop telegraf

Se o seu sistema operacional não estiver usando systemd:

sudo service telegraf start
sudo service telegraf stop

Desinstalar o agente

Para desinstalar o agente no Ubuntu/Debian, em um terminal Bash, execute o seguinte:

  1. Pare o serviço Telegraf:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Remova o agente Telegraf:

     dpkg -r telegraf
. Remova qualquer configuração ou arquivos de log que possam ser deixados para trás:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Atualizando o agente

Para atualizar o agente telegraf, faça o seguinte:

  1. Pare o serviço telegraf:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Remova o agente telegraf anterior:

     dpkg -r telegraf
. link:#ubuntu-and-debian["Instale o novo agente"].

Verificando somas de verificação do pacote Telegraf

O instalador do agente Data Infrastructure Insights executa verificações de integridade, mas alguns usuários podem querer executar suas próprias verificações antes de instalar o binário Telegraf baixado. Isso pode ser feito baixando o instalador e gerando uma soma de verificação para o pacote baixado e comparando a soma de verificação com o valor mostrado nas instruções de instalação.

Baixe o pacote de instalação sem instalar

Para executar uma operação somente de download (em oposição ao download-e-install padrão), os usuários podem editar o comando de instalação do agente obtido a partir da interface do usuário e remover a opção "install".

Siga estes passos:

  1. Copie o snippet do Agent Installer como indicado.

  2. Em vez de colar o snippet em uma janela de comando, cole-o em um editor de texto.

  3. Remova o comando "--install" (Linux) ou "-install" (Windows).

  4. Copie o comando inteiro do editor de texto.

  5. Agora cole-o em sua janela de comando (em um diretório de trabalho) e execute-o.

Não Windows (estes exemplos são para o Kubernetes; os nomes de script reais podem variar):

  • Transferir e instalar (predefinição):

     installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify && sudo -E -H ./$installerName --install
* Apenas transferência:
    installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify

Windows:

  • Transferir e instalar (predefinição):

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify -install } else { Write-Host "Install script checksum does not match"})"
* Apenas transferência:
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify } else { Write-Host "Install script checksum does not match"})"

O comando somente download fará o download de todos os artefatos necessários do Data Infrastructure Insights para o diretório de trabalho. Os artefactos incluem, mas podem não estar limitados a:

  • um script de instalação

  • um arquivo de ambiente

  • Um binário Telegraf

  • Uma assinatura para o binário Telegraf

  • um certificado público para verificar a assinatura binária

O snippet de instalação baixado e copiado do DII verifica automaticamente o script de instalação e a assinatura do binário telegraf é verificada pelo script de instalação.

Verifique o valor da soma de verificação

Para gerar o valor da soma de verificação, execute o seguinte comando para sua plataforma apropriada:

  • RHEL/Ubuntu:

     sha256sum <package_name>
* Windows:
    Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List

Instale o pacote transferido

Uma vez que todos os artefatos tenham sido verificados satisfatoriamente, a instalação do agente pode ser iniciada executando:

Não janelas:

 sudo -E -H ./<installation_script_name> --install
Windows:
.\cloudinsights-windows.ps1 -install

Criando e usando tokens de acesso à API

Para criar um token de acesso à API para ingestão de dados Telegraf, siga um destes procedimentos:

Crie através da página de instalação do Data Collector

  1. Navegue até a página de instalação do Data Collector para a plataforma que você deseja usar (Windows, Linux).

  2. Crie um token com o botão Token de Acesso à API.

  3. Introduza um nome e clique em Guardar.

  4. O nome do token agora deve ser selecionado no menu suspenso e será usado ao instalar o coletor.

Crie manualmente um token de acesso à API

  1. Navegue até Admin>Acesso à API.

  2. Clique em API Access Token.

  3. Insira um nome e, opcionalmente, uma descrição.

  4. Em "que tipo de APIs esse token será usado para chamar?", selecione "ingestão de dados" somente e, em seguida, desmarque "Unidade de aquisição".

  5. Em "permissões", selecione ler/escrever.

  6. Desmarque "rotacionar automaticamente tokens para Kubernetes".

Para usar seu token de acesso à API recém-criado, selecione-o no menu suspenso "Selecionar token de acesso à API existente ou criar um novo" na página do instalador. Observe que somente tokens com as seguintes propriedades podem ser usados:

  • Tipo de API: Somente "ingestão de dados"

  • Permissões: Ler/escrever

  • Rotação automática do Kubernetes: Desligada

Solução de problemas

Algumas coisas para tentar se você encontrar problemas para configurar um agente:

Problema: Tente isto:

Depois de configurar um novo plugin e reiniciar o Telegraf, o Telegraf não consegue iniciar. Os logs indicam que um erro semelhante ao seguinte: "[telegraf] erro ao executar agente: Erro ao carregar arquivo de configuração /etc/telegraf/telegraf.d/cloudinsights-default.conf: Plugin outputs.http: Line <linenumber>: Configuration especificou os campos ["use_system_proxy"], mas eles não foram usados"

A versão instalada do Telegraf está desatualizada. Siga as etapas nesta página para Atualizar o Agente para sua plataforma apropriada.

Eu executei o script do instalador em uma instalação antiga e agora o agente não está enviando dados

Desinstale o agente telegraf e execute novamente o script de instalação. Siga as etapas Upgrade the Agent nesta página para sua plataforma apropriada.

Já instalei um agente usando o Data Infrastructure Insights

Se você já tiver instalado um agente em seu host/VM, não será necessário instalar o agente novamente. Nesse caso, basta escolher a Plataforma e chave apropriadas na tela Instalação do Agente e clicar em continuar ou concluir.

Já tenho um agente instalado, mas não usando o instalador Data Infrastructure Insights

Remova o agente anterior e execute a instalação do Data Infrastructure Insights Agent para garantir as configurações padrão adequadas do arquivo de configuração. Quando terminar, clique em continuar ou concluir.

Informações adicionais podem ser encontradas na "Suporte" página ou no "Matriz de suporte do Data Collector".