Skip to main content
Data Infrastructure Insights
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

데이터 수집을 위한 에이전트 구성(Windows/Linux)

기여자 netapp-alavoie dgracenetapp netapp-mjryan
PDF

Data Infrastructure Insights 사용"텔레그라프" 통합 데이터 수집을 위한 에이전트로서. Telegraf는 메트릭, 이벤트, 로그를 수집하고 보고하는 데 사용할 수 있는 플러그인 기반 서버 에이전트입니다. 입력 플러그인은 시스템/OS에 직접 접근하거나, 타사 API를 호출하거나, 구성된 스트림(예: Kafka, statsD 등)을 수신하여 원하는 정보를 에이전트에 수집하는 데 사용됩니다. 출력 플러그인은 수집된 메트릭, 이벤트 및 로그를 에이전트에서 Data Infrastructure Insights 로 전송하는 데 사용됩니다.

Kubernetes에 설치하는 방법에 대한 정보는 다음을 참조하세요."NetApp Kubernetes 모니터링 운영자" 페이지.

참고 정확한 감사 및 데이터 보고를 위해서는 네트워크 시간 프로토콜(NTP) 또는 *단순 네트워크 시간 프로토콜(SNTP)*을 사용하여 에이전트 컴퓨터의 시간을 동기화하는 것이 좋습니다.
참고 Agent를 설치하기 전에 설치 파일을 확인하려면 아래 섹션을 참조하세요.Telegraf 패키지 체크섬 확인 .

에이전트 설치

서비스 데이터 수집기를 설치하고 아직 에이전트를 구성하지 않은 경우, 먼저 해당 운영 체제에 맞는 에이전트를 설치하라는 메시지가 표시됩니다. 이 항목에서는 다음 운영 체제에 Telegraf 에이전트를 설치하는 방법에 대한 지침을 제공합니다.

플랫폼에 관계없이 에이전트를 설치하려면 먼저 다음을 수행해야 합니다.

  1. 에이전트로 사용할 호스트에 로그인하세요.

  2. Data Infrastructure Insights 환경에 로그인하고 *관찰성 > 수집기*로 이동합니다.

  3. *+데이터 수집기*를 클릭하고 설치할 데이터 수집기를 선택하세요.

  4. 호스트에 적합한 플랫폼(Windows, Linux)을 선택하세요

  5. 각 플랫폼에 대한 나머지 단계를 따르세요.

참고 호스트에 에이전트를 설치한 후에는 해당 호스트에 다시 에이전트를 설치할 필요가 없습니다.
팁 서버/VM에 에이전트를 설치하면 Data Infrastructure Insights는 사용자가 구성한 데이터 수집기에서 수집하는 데이터 외에도 해당 시스템에서 메트릭을 수집합니다. 이러한 메트릭은 "노드" 메트릭으로 수집됩니다.
참고 프록시를 사용하는 경우 Telegraf 에이전트를 설치하기 전에 해당 플랫폼의 프록시 지침을 읽으세요.

로그 위치

Telegraf 로그 메시지는 기본적으로 stdout에서 다음 로그 파일로 리디렉션됩니다.

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

  • 우분투/데비안: /var/log/telegraf/telegraf.log

  • 윈도우: C:\Program Files\telegraf\telegraf.log

Windows

필수 조건:

  • PowerShell을 설치해야 합니다.

  • 프록시를 사용하는 경우 Windows에 대한 프록시 지원 구성 섹션의 지침을 따라야 합니다.

Windows용 프록시 지원 구성

참고 환경에서 프록시를 사용하는 경우 설치하기 전에 이 섹션을 읽어보세요.
참고 아래 단계에서는 http_proxy/https_proxy 환경 변수를 설정하는 데 필요한 작업을 간략하게 설명합니다. 일부 프록시 환경에서는 사용자가 _no_proxy 환경 변수를 설정해야 할 수도 있습니다.

프록시 뒤에 있는 시스템의 경우 Telegraf 에이전트를 설치하기 전에 다음을 수행하여 https_proxy 및/또는 http_proxy 환경 변수를 설정하세요.

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

에이전트 설치

Windows 에이전트 설치

Windows에 에이전트를 설치하는 단계:

  1. 에이전트 액세스 키를 선택하세요.

  2. 에이전트 설치 대화 상자에서 명령 블록을 복사합니다. 클립보드 아이콘을 클릭하면 명령을 빠르게 클립보드에 복사할 수 있습니다.

  3. PowerShell 창을 엽니다

  4. PowerShell 창에 명령을 붙여넣고 Enter를 누릅니다.

  5. 이 명령을 실행하면 적절한 에이전트 설치 프로그램이 다운로드되고, 설치되고, 기본 구성이 설정됩니다. 완료되면 에이전트 서비스가 다시 시작됩니다. 해당 명령은 고유한 키를 가지고 있으며 24시간 동안 유효합니다.

  6. 마침 또는 *계속*을 클릭하세요.

에이전트가 설치된 후 다음 명령을 사용하여 서비스를 시작/중지할 수 있습니다.

Start-Service telegraf
Stop-Service telegraf

에이전트 제거

Windows에서 에이전트를 제거하려면 PowerShell 창에서 다음을 수행합니다.

  1. Telegraf 서비스를 중지하고 삭제합니다.

    Stop-Service telegraf
sc.exe delete telegraf

  2. 트러스토어에서 인증서를 제거합니다.

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

  3. 바이너리, 로그 및 구성 파일을 제거하려면 C:\Program Files\telegraf 폴더를 삭제하세요.

  4. 레지스트리에서 SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf 키를 제거합니다.

에이전트 업그레이드

Telegraf 에이전트를 업그레이드하려면 다음을 수행하세요.

  1. Telegraf 서비스를 중지하고 삭제합니다.

    Stop-Service telegraf
sc.exe delete telegraf

  2. 레지스트리에서 SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf 키를 삭제합니다.

  3. C:\Program Files\telegraf\telegraf.conf 삭제

  4. C:\Program Files\telegraf\telegraf.exe 삭제

  5. "새로운 에이전트를 설치하세요" .

RHEL과 CentOS

필수 조건:

  • 다음 명령을 사용할 수 있어야 합니다: curl, sudo, ping, sha256sum, openssl 및 dmidecode

  • 프록시를 사용하는 경우 RHEL/CentOS에 대한 프록시 지원 구성 섹션의 지침을 따라야 합니다.

RHEL/CentOS에 대한 프록시 지원 구성

참고 환경에서 프록시를 사용하는 경우 설치하기 전에 이 섹션을 읽어보세요.
참고 아래 단계에서는 http_proxy/https_proxy 환경 변수를 설정하는 데 필요한 작업을 간략하게 설명합니다. 일부 프록시 환경에서는 사용자가 _no_proxy 환경 변수를 설정해야 할 수도 있습니다.

프록시 뒤에 있는 시스템의 경우 Telegraf 에이전트를 설치하기 전에 다음 단계를 수행하세요.

  1. 현재 사용자에 대해 https_proxy 및/또는 http_proxy 환경 변수를 설정합니다.

     export https_proxy=<proxy_server>:<proxy_port>
. _/etc/default/telegraf_를 만들고 _https_proxy_ 및/또는 _http_proxy_ 변수에 대한 정의를 삽입합니다.
    https_proxy=<proxy_server>:<proxy_port>

에이전트 설치

Rhel/CentOS 에이전트 설치

RHEL/CentOS에 에이전트를 설치하는 단계:

  1. 에이전트 액세스 키를 선택하세요.

  2. 에이전트 설치 대화 상자에서 명령 블록을 복사합니다. 클립보드 아이콘을 클릭하면 명령을 빠르게 클립보드에 복사할 수 있습니다.

  3. Bash 창을 엽니다

  4. Bash 창에 명령을 붙여넣고 Enter를 누릅니다.

  5. 이 명령을 실행하면 적절한 에이전트 설치 프로그램이 다운로드되고, 설치되고, 기본 구성이 설정됩니다. 완료되면 에이전트 서비스가 다시 시작됩니다. 해당 명령은 고유한 키를 가지고 있으며 24시간 동안 유효합니다.

  6. 마침 또는 *계속*을 클릭하세요.

에이전트가 설치된 후 다음 명령을 사용하여 서비스를 시작/중지할 수 있습니다.

운영 체제가 systemd를 사용하는 경우(CentOS 7 이상 및 RHEL 7 이상):

sudo systemctl start telegraf
sudo systemctl stop telegraf

운영 체제가 systemd를 사용하지 않는 경우(CentOS 7 이상 및 RHEL 7 이상):

sudo service telegraf start
sudo service telegraf stop

에이전트 제거

RHEL/CentOS에서 에이전트를 제거하려면 Bash 터미널에서 다음을 수행합니다.

  1. 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. Telegraf 에이전트를 제거합니다.

     yum remove telegraf
. 남아 있을 수 있는 구성 또는 로그 파일을 제거하세요.
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

에이전트 업그레이드

Telegraf 에이전트를 업그레이드하려면 다음을 수행하세요.

  1. 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. 이전 Telegraf 에이전트를 제거합니다.

     yum remove telegraf
. link:#rhel-and-centos["새로운 에이전트를 설치하세요"] .

우분투와 데비안

필수 조건:

  • 다음 명령을 사용할 수 있어야 합니다: curl, sudo, ping, sha256sum, openssl 및 dmidecode

  • 프록시를 사용하는 경우 Ubuntu/Debian에 대한 프록시 지원 구성 섹션의 지침을 따라야 합니다.

Ubuntu/Debian에 대한 프록시 지원 구성

참고 환경에서 프록시를 사용하는 경우 설치하기 전에 이 섹션을 읽어보세요.
참고 아래 단계에서는 http_proxy/https_proxy 환경 변수를 설정하는 데 필요한 작업을 간략하게 설명합니다. 일부 프록시 환경에서는 사용자가 _no_proxy 환경 변수를 설정해야 할 수도 있습니다.

프록시 뒤에 있는 시스템의 경우 Telegraf 에이전트를 설치하기 전에 다음 단계를 수행하세요.

  1. 현재 사용자에 대해 https_proxy 및/또는 http_proxy 환경 변수를 설정합니다.

     export https_proxy=<proxy_server>:<proxy_port>
. /etc/default/telegraf를 만들고 _https_proxy_ 및/또는 _http_proxy_ 변수에 대한 정의를 삽입합니다.
    https_proxy=<proxy_server>:<proxy_port>

에이전트 설치

Ubuntu/Debian 에이전트 설치

Debian 또는 Ubuntu에 에이전트를 설치하는 단계:

  1. 에이전트 액세스 키를 선택하세요.

  2. 에이전트 설치 대화 상자에서 명령 블록을 복사합니다. 클립보드 아이콘을 클릭하면 명령을 빠르게 클립보드에 복사할 수 있습니다.

  3. Bash 창을 엽니다

  4. Bash 창에 명령을 붙여넣고 Enter를 누릅니다.

  5. 이 명령을 실행하면 적절한 에이전트 설치 프로그램이 다운로드되고, 설치되고, 기본 구성이 설정됩니다. 완료되면 에이전트 서비스가 다시 시작됩니다. 해당 명령은 고유한 키를 가지고 있으며 24시간 동안 유효합니다.

  6. 마침 또는 *계속*을 클릭하세요.

에이전트가 설치된 후 다음 명령을 사용하여 서비스를 시작/중지할 수 있습니다.

운영 체제가 systemd를 사용하는 경우:

sudo systemctl start telegraf
sudo systemctl stop telegraf

운영 체제가 systemd를 사용하지 않는 경우:

sudo service telegraf start
sudo service telegraf stop

에이전트 제거

Ubuntu/Debian에서 에이전트를 제거하려면 Bash 터미널에서 다음을 실행합니다.

  1. Telegraf 서비스를 중지합니다.

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

  2. Telegraf 에이전트를 제거합니다.

     dpkg -r telegraf
. 남아 있을 수 있는 구성 또는 로그 파일을 제거하세요.
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

에이전트 업그레이드

Telegraf 에이전트를 업그레이드하려면 다음을 수행하세요.

  1. Telegraf 서비스를 중지합니다.

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

  2. 이전 Telegraf 에이전트를 제거합니다.

     dpkg -r telegraf
. link:#ubuntu-and-debian["새로운 에이전트를 설치하세요"] .

Telegraf 패키지 체크섬 확인

Data Infrastructure Insights 에이전트 설치 프로그램은 무결성 검사를 수행하지만 일부 사용자는 다운로드한 Telegraf 바이너리를 설치하기 전에 직접 확인을 수행하려고 할 수 있습니다. 설치 프로그램을 다운로드하고 다운로드한 패키지에 대한 체크섬을 생성한 다음, 체크섬을 설치 지침에 표시된 값과 비교하면 됩니다.

설치하지 않고 설치 프로그램 패키지를 다운로드하세요

다운로드 전용 작업(기본 다운로드 및 설치와 반대)을 수행하려면 사용자는 UI에서 얻은 에이전트 설치 명령을 편집하고 "설치" 옵션을 제거할 수 있습니다.

다음 단계를 따르세요.

  1. 지시된 대로 Agent Installer 스니펫을 복사합니다.

  2. 스니펫을 명령 창에 붙여 넣는 대신 텍스트 편집기에 붙여 넣으세요.

  3. 명령어에서 마지막의 "--install"(Linux) 또는 "-install"(Windows)을 제거합니다.

  4. 텍스트 편집기에서 전체 명령을 복사합니다.

  5. 이제 명령 창(작업 디렉토리)에 붙여넣고 실행하세요.

Windows가 아닌 경우(이 예시는 Kubernetes에 대한 것이며 실제 스크립트 이름은 다를 수 있음):

  • 다운로드 및 설치(기본값):

     installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify && sudo -E -H ./$installerName --install
* 다운로드 전용:
    installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify

윈도우:

  • 다운로드 및 설치(기본값):

     !$($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"})"
* 다운로드 전용:
    !$($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"})"

다운로드 전용 명령은 Data Infrastructure Insights 에서 작업 디렉터리로 필요한 모든 아티팩트를 다운로드합니다. 유물에는 다음이 포함되지만 이에 국한되지는 않습니다.

  • 설치 스크립트

  • 환경 파일

  • Telegraf 바이너리

  • Telegraf 바이너리에 대한 서명

  • 이진 서명을 검증하기 위한 공개 인증서

DII에서 다운로드하여 복사한 설치 스니펫은 자동으로 설치 스크립트의 체크섬을 계산하고, Telegraf 바이너리의 서명은 설치 스크립트에 의해 검증됩니다.

체크섬 값 확인

체크섬 값을 생성하려면 해당 플랫폼에 맞는 다음 명령을 실행하세요.

  • RHEL/우분투:

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

다운로드한 패키지를 설치하세요

모든 아티팩트가 만족스럽게 검증되면 다음을 실행하여 에이전트 설치를 시작할 수 있습니다.

Windows가 아닌 경우:

 sudo -E -H ./<installation_script_name> --install
윈도우:
.\cloudinsights-windows.ps1 -install

API 액세스 토큰 생성 및 사용

Telegraf 데이터 수집을 위한 API 액세스 토큰을 생성하려면 다음 중 하나를 수행하세요.

데이터 수집기 설치 페이지를 통해 생성

  1. 사용하려는 플랫폼(Windows, Linux)에 맞는 Data Collector 설치 페이지로 이동합니다.

  2. + API 액세스 토큰 버튼을 사용하여 토큰을 생성합니다.

  3. 이름을 입력하고 저장을 클릭하세요.

  4. 이제 드롭다운에서 토큰 이름을 선택해야 하며, 수집기를 설치할 때 이 이름이 사용됩니다.

API 액세스 토큰을 수동으로 생성

  1. 관리>API 액세스로 이동합니다.

  2. + API 액세스 토큰을 클릭하세요.

  3. 이름과 설명(선택 사항)을 입력하세요.

  4. "이 토큰은 어떤 유형의 API를 호출하는 데 사용됩니까?"에서 "데이터 수집"만 선택한 다음 "획득 단위"의 선택을 취소합니다.

  5. "권한"에서 읽기/쓰기를 선택합니다.

  6. "Kubernetes에 대한 토큰을 자동으로 회전"을 선택 해제합니다.

새로 만든 API 액세스 토큰을 사용하려면 설치 프로그램 페이지의 "기존 API 액세스 토큰 선택 또는 새 토큰 만들기" 드롭다운에서 해당 토큰을 선택하세요. 다음 속성을 가진 토큰만 사용할 수 있습니다.

  • API 유형: "데이터 수집"만

  • 권한: 읽기/쓰기

  • Kubernetes 자동 회전: 꺼짐

문제 해결

에이전트 설정에 문제가 발생하면 시도해 볼 수 있는 몇 가지 사항:

문제: 다음을 시도해 보세요:

새로운 플러그인을 구성하고 Telegraf를 다시 시작한 후 Telegraf가 시작되지 않습니다. 로그는 다음과 유사한 오류를 나타냅니다. "[telegraf] 에이전트 실행 오류: 구성 파일 /etc/telegraf/telegraf.d/cloudinsights-default.conf를 로드하는 중 오류가 발생했습니다. 플러그인 출력.http: 줄 <줄 번호>: 구성에서 ["use_system_proxy"] 필드를 지정했지만 사용되지 않았습니다."

설치된 Telegraf 버전이 오래되었습니다. 해당 플랫폼에 맞게 *에이전트를 업그레이드*하려면 이 페이지의 단계를 따르세요.

이전 설치에서 설치 프로그램 스크립트를 실행했는데 이제 에이전트가 데이터를 전송하지 않습니다.

Telegraf 에이전트를 제거한 다음 설치 스크립트를 다시 실행합니다. 이 페이지에서 해당 플랫폼에 맞는 에이전트 업그레이드 단계를 따르세요.

Data Infrastructure Insights 사용하여 이미 에이전트를 설치했습니다.

호스트/VM에 이미 에이전트를 설치한 경우 에이전트를 다시 설치할 필요가 없습니다. 이 경우, 에이전트 설치 화면에서 적절한 플랫폼과 키를 선택하고 계속 또는 *마침*을 클릭하세요.

Data Infrastructure Insights 설치 프로그램을 사용하지 않고 이미 에이전트를 설치했습니다.

이전 에이전트를 제거하고 Data Infrastructure Insights Agent 설치를 실행하여 기본 구성 파일 설정이 올바르게 적용되도록 합니다. 완료되면 계속 또는 *마침*을 클릭하세요.

추가 정보는 다음에서 찾을 수 있습니다."지원하다" 페이지 또는"데이터 수집기 지원 매트릭스" .