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"Telégrafo" como seu agente para coleta de dados de integração. O Telegraf é um agente de servidor controlado por plugin que pode ser usado para coletar e relatar métricas, eventos e logs. Os plugins de entrada são usados ​​para coletar as informações desejadas no agente acessando o sistema/SO diretamente, chamando APIs de terceiros ou ouvindo fluxos configurados (por exemplo, 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 a instalação no Kubernetes, consulte o"Operador de monitoramento do NetApp Kubernetes" página.

Observação Para auditoria e relatórios de dados precisos, é altamente recomendável sincronizar o horário 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 sobreVerificando somas de verificação de pacotes 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ê primeiro instale 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, você deve primeiro fazer o seguinte:

  1. Efetue login no host que você usará para seu agente.

  2. Efetue login no seu ambiente do Data Infrastructure Insights e navegue até Observabilidade > Coletores.

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

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

  5. Siga os passos restantes para cada plataforma.

Observação Depois de instalar um agente em um host, você não precisa instalá-lo 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 dados de quaisquer coletores de dados que você configurar. Essas métricas são coletadas como"Métricas de "nó"" .
Observação Se você estiver usando um proxy, leia as instruções do proxy para sua plataforma antes de instalar o agente Telegraf.

Locais de registro

As mensagens de log do Telegraf são redirecionadas do stdout para os seguintes arquivos de log por 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 a proxy para Windows.

Configurando o suporte a proxy para Windows

Observação Se o seu ambiente usa 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 de proxy, os usuários também podem precisar definir a variável de ambiente no_proxy.

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

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

Instalando o agente

Instalação do agente do Windows

Etapas para instalar o agente no Windows:

  1. Escolha uma chave de acesso do agente.

  2. Copie o bloco de comando 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 baixará o instalador do agente apropriado, instalará-o e definirá uma configuração padrão. Quando terminar, o serviço do agente será reiniciado. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Concluir ou Continuar

Após a instalação do agente, você pode usar os seguintes comandos para iniciar/parar o serviço:

Start-Service telegraf
Stop-Service telegraf

Desinstalando o Agente

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

  1. Pare e exclua o serviço Telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Remova o certificado do truststore:

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

  3. Exclua a pasta C:\Program Files\telegraf para remover os arquivos binários, de log e de configuração

  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. Pare e exclua 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 C:\Arquivos de Programas\telegraf\telegraf.conf

  4. Excluir C:\Arquivos de Programas\telegraf\telegraf.exe

  5. "Instalar 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 a proxy para RHEL/CentOS.

Configurando o suporte de proxy para RHEL/CentOS

Observação Se o seu ambiente usa 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 de proxy, os usuários também podem precisar definir a variável de ambiente no_proxy.

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

  1. Defina as variáveis 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 do agente.

  2. Copie o bloco de comando 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 do Bash e pressione Enter.

  5. O comando baixará o instalador do agente apropriado, instalará-o e definirá uma configuração padrão. Quando terminar, o serviço do agente será reiniciado. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Concluir ou Continuar

Após a instalação do agente, você pode usar os seguintes comandos para iniciar/parar o serviço:

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

sudo systemctl start telegraf
sudo systemctl stop telegraf

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

sudo service telegraf start
sudo service telegraf stop

Desinstalando 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 quaisquer arquivos de configuração ou log que possam ter sido 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 de telégrafo:

    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 telegráfico anterior:

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

Ubuntu e Debian

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 a proxy para Ubuntu/Debian.

Configurando o suporte a proxy para Ubuntu/Debian

Observação Se o seu ambiente usa 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 de proxy, os usuários também podem precisar definir a variável de ambiente no_proxy.

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

  1. Defina as variáveis 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

Etapas para instalar o agente no Debian ou Ubuntu:

  1. Escolha uma chave de acesso do agente.

  2. Copie o bloco de comando 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 do Bash e pressione Enter.

  5. O comando baixará o instalador do agente apropriado, instalará-o e definirá uma configuração padrão. Quando terminar, o serviço do agente será reiniciado. O comando tem uma chave única e é válido por 24 horas.

  6. Clique em Concluir ou Continuar

Após a instalação do agente, você pode 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

Desinstalando 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 quaisquer arquivos de configuração ou log que possam ter sido 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 de telégrafo:

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

  2. Remova o agente telegráfico anterior:

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

Verificando somas de verificação de pacotes Telegraf

O instalador do agente do Data Infrastructure Insights executa verificações de integridade, mas alguns usuários podem querer realizar suas próprias verificações antes de instalar o binário do Telegraf baixado. Isso pode ser feito baixando o instalador e gerando uma soma de verificação para o pacote baixado e, em seguida, 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 instalação padrão), os usuários podem editar o comando de instalação do agente obtido na interface do usuário e remover a opção “instalar”.

Siga estes passos:

  1. Copie o snippet do instalador do agente conforme as instruções.

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

  3. Remova o final “--install” (Linux) ou “-install” (Windows) do comando.

  4. Copie o comando inteiro do editor de texto.

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

Não Windows (esses exemplos são para Kubernetes; os nomes reais dos scripts podem variar):

  • Baixar e instalar (padrão):

     installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify && sudo -E -H ./$installerName --install
* Somente para download:
    installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify

Windows:

  • Baixar e instalar (padrã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"})"
* Somente para download:
    !$($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 baixará todos os artefatos necessários do Data Infrastructure Insights para o diretório de trabalho. Os artefatos incluem, mas não estão 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 do telegraf é verificada pelo script de instalação.

Verificar valor de 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 baixado

Depois que todos os artefatos forem verificados satisfatoriamente, a instalação do agente pode ser iniciada executando:

Não Windows:

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

Criação e uso de tokens de acesso à API

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

Criar através da página de instalação do coletor de dados

  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. Insira um nome e clique em salvar.

  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 + Token de acesso à API.

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

  4. Em “Que tipo de APIs este token será usado para chamar?”, selecione apenas “Ingestão de dados” e depois desmarque “Unidade de aquisição”.

  5. Em “Permissões”, selecione Leitura/Gravação.

  6. Desmarque “Girar tokens automaticamente 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: Leitura/Escrita

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

Solução de problemas

Algumas coisas que você pode tentar se tiver problemas ao configurar um agente:

Problema: Experimente isto:

Após configurar um novo plugin e reiniciar o Telegraf, o Telegraf não inicia. Os logs indicam um erro semelhante ao seguinte: "[telegraf] Erro ao executar o agente: Erro ao carregar o arquivo de configuração /etc/telegraf/telegraf.d/cloudinsights-default.conf: plugin outputs.http: linha <número da linha>: a configuração 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.

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 de Atualizar o Agente nesta página para sua plataforma apropriada.

Já instalei um agente usando o Data Infrastructure Insights

Se você já instalou um agente no seu host/VM, não precisa instalá-lo novamente. Nesse caso, basta escolher a plataforma e a chave apropriadas na tela de instalação do agente e clicar em Continuar ou Concluir.

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

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

Informações adicionais podem ser encontradas em"Apoiar" página ou no"Matriz de Suporte ao Coletor de Dados" .