Linux용 인프라 에이전트 Tarball 수동 설치

인프라 모니터링을 위한 맞춤형 Linux 설치 프로세스를 통해 설치 프로세스의 모든 측면을 조정하고 파일 시스템에 파일과 폴더를 배치할 수 있습니다. 설치를 완전히 제어할 수 있습니다.

주의

수동 설치 프로세스는 감독되지 않습니다. 수동 설치를 선택한 경우 다른 파일을 올바른 폴더에 배치하고 매개변수화된 올바른 구성 값을 제공하며 에이전트가 실행할 수 있는 모든 권한을 갖도록 해야 합니다.

에이전트 설치

설치하기 전에 호환성 및 요구 사항 을 확인하십시오.

추가 에이전트 패키지 옵션	코멘트
문제점 해결	인프라 에이전트 패키지에는 실행 중인 에이전트의 문제 를 해결하는 데 사용되는 추가 `newrelic-infra-ctl` 바이너리가 포함되어 있습니다. 이 바이너리는 에이전트를 실행하는 데 필요하지 않지만 경로에 추가하는 것이 좋습니다.
데몬 프로세스	버전 1.5.59 부터 인프라 에이전트 패키지에는 일반 에이전트 데몬 프로세스 `newrelic-infra` 를 안전하게 관리하는 데 사용되는 추가 `newrelic-infra-service` 바이너리가 포함됩니다.

에이전트를 설치하려면:

패키지된 에이전트 파일 을 다운로드하거나 특정 버전의 에이전트, 해당 체크섬을 자동으로 가져와 다운로드 후 확인하는 다음 명령을 사용합니다.ARCH=amd64 을 원하는 아키텍처(amd64, 386, arm64, arm)로 바꾸고 V=1.27.4 을 최신 또는 특정 버전 으로 바꿉니다.
bash
```
$V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read    url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }
```
버전 1.27.4 부터 tar.gz 패키지 GPG 서명을 제공합니다.GitHub의 infra-agent 저장소에서 서명 절차 및 확인 지침을 확인할 수 있습니다.
파일의 압축을 풉니다.
파일이 다음 구조로 압축 해제되었는지 확인하십시오.
```
newrelic-infra
|-- config_defaults.sh
|-- etc
|   |-- init_scripts
|   |   |-- systemd
|   |   |   `-- newrelic-infra.service
|   |   |-- sysv
|   |   |   `-- newrelic-infra
|   |   `-- upstart
|   |       `-- newrelic-infra
|   `-- newrelic-infra
|       `-- integrations.d
|-- installer.sh
|-- usr
|   `-- bin
|       |-- newrelic-infra
|       |-- newrelic-infra-ctl
|       `-- newrelic-infra-service
`-- var
    |-- db
    |   `-- newrelic-infra
    |       |-- custom-integrations
    |       |-- integrations.d
    |       |-- LICENSE.txt
    |       `-- newrelic-integrations
    |-- log
    |   `-- newrelic-infra
    `-- run
        `-- newrelic-infra
```
서비스 스크립트를 설치합니다 .
선택 사항: 추가 설치 단계 .

설치: 선택적 단계

다음 추가 단계를 수행할 수도 있습니다.

구성 파일의 위치를 변경합니다 .
PID 파일의 위치를 변경하십시오 .
사용자 및 런타임 모드를 변경합니다 .
플러그인 디렉토리를 구성하십시오 .
에이전트 디렉토리를 구성하십시오 .
로그 파일을 구성합니다 .
에이전트 바이너리의 위치를 변경합니다 .

이 문서가 설치하는데 도움이 되셨나요?

서비스 스크립트 설치

서비스 스크립트 설치를 진행하기 전에 시스템에서 사용 중인 서비스 관리자를 확인해야 합니다.

지원되는 서비스 관리자(SystemD, SysV, Upstart) 중 하나를 사용하는 경우 tarball에서 제공하는 서비스 스크립트를 사용하십시오.
지원하지 않는 서비스 관리자를 사용하는 경우 자체 서비스 스크립트를 작성해야 합니다.

중요

의심스러운 경우 Linux 배포의 공식 문서를 확인하십시오.

호스트에서 사용 중인 서비스 관리자를 프로그래밍 방식으로 알 수 있는 좋은 방법은 없지만 몇 가지 경험적 방법을 제공할 수 있습니다.

서비스 관리자를 확인하려면 다음 명령을 사용하십시오.

command -v systemctl (Systemd에서 사용)
command -v update-rc.d (SysV에서 사용)
command -v initctl (Upstart에서 사용)
출력을 반환하는 첫 번째 명령은 시스템에서 사용하는 서비스 관리자를 나타냅니다.
팁
예를 들어 다음 시퀀스를 실행합니다.
bash
```
$command -v systemctl
$command -v initctl
/sbin/initctl
```
이 출력을 기반으로 Upstart는 반환을 얻은 명령이기 때문에 서비스 관리자입니다.

중요

서비스 관리자 스크립트를 복사하기 전에 사용자, 에이전트 바이너리의 경로 또는 pid 파일 위치를 변경해야 하는지 확인하십시오. 이러한 모든 변경 사항은 서비스 스크립트에 반영되어야 합니다.

지원되는 서비스 관리자 중 하나를 사용하는 경우 호스트에 대한 서비스 스크립트를 설치합니다.

서비스 파일 ./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.service 복사 /etc/systemd/system/newrelic-infra.service
서비스 스크립트를 활성화합니다.
bash
```
$systemctl enable newrelic-infra.service
```

서비스 파일 ./newrelic-infra/etc/init_scripts/sysv/newrelic-infra 복사 /etc/init.d/system/newrelic-infra

다음 명령을 실행합니다.

bash

$update-rc.d newrelic-infra defaults
$update-rc.d newrelic-infra enable

서비스 스크립트가 구성되었습니다. 나머지 옵션을 구성하고 서비스를 수동으로 시작합니다.

구성 파일의 위치 변경

인프라 에이전트에는 에이전트의 동작을 미세 조정하기 위해 일반적으로 newrelic-infra.yml 이라는 구성 파일이 포함되어 있습니다. 자세한 내용은 구성 파일 템플릿 및 에이전트 구성 방법을 참조하십시오.

기본적으로 에이전트는 다음 위치 중 하나에서 구성 파일을 검색합니다.

newrelic-infra.yml (작업 디렉토리 루트 폴더)
/etc/newrelic-infra.yml
/etc/newrelic-infra/newrelic-infra.yml

다른 위치를 지정하려면 -config 플래그 명령줄을 사용합니다. 예를 들어:

bash

$usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml

이 변경 사항을 영구적으로 적용하려면 서비스 스크립트를 편집하십시오.

pid 파일 위치 변경

인프라 에이전트는 실행 중인 에이전트 인스턴스를 식별하는 데 사용되는 프로세스 식별 번호(pid)를 유지하기 위해 pid-file 을 사용합니다. pid-file 의 위치를 변경하는 방법은 에이전트가 구성된 방식에 따라 다릅니다.

중요

기본적으로 에이전트는 pid-file 을 생성하는 것이 좋습니다. 필요한 경우 위치를 수정할 수 있습니다.

pid-file 의 위치를 변경하려면:

시작 시 에이전트는 프로세스 pid 를 pid-file 에 씁니다. 파일이 존재하지 않으면 생성됩니다.

기본적으로 에이전트는 /var/run/newrelic-infra/newrelic-infra.pid 경로를 사용하여 pid-file 을 생성합니다. 수정하려면 다음 옵션 중 하나를 사용하십시오.

구성 파일 newrelic-infra.yml 에 pid_file 구성 옵션을 추가합니다.
newrelic-infra 바이너리를 실행할 때 명령줄을 사용하여 pid_file 를 제공합니다.
NRIA_PID_FILE 환경 변수를 설정합니다.
중요
에이전트는 초기화될 때마다 pid-file 을 생성하거나 업데이트하므로 에이전트를 실행하는 사용자는 pid-file 위치에 대한 읽기/쓰기 권한이 있어야 합니다.
chown 명령을 사용하여 사용자에게 소유자 권한을 부여합니다. 예를 들어, 사용자 nri-agent 이 에이전트를 실행 중이고 pid-file 위치가 /var/run/newrelic-infra-custom/nr.pid 으로 설정된 경우 다음을 사용하여 사용자 권한을 부여할 수 있습니다.
bash
```
$chown nri-agent:nri-agent /var/run/newrelic-infra-custom/
```

주의

PIDFILE 환경 변수를 사용하여 pid-file 을 관리하지 않는 것이 좋습니다.

환경 변수 PIDFILE 이 설정되면 에이전트는 pid-file 생성을 시도하지 않습니다. 원하는 위치에 pid-file 를 만듭니다.

팁

다른 사람이 pid-file 수명 주기를 관리하는 경우 이 접근 방식을 사용하세요. 예를 들어, 우리의 init 스크립트는 SysV와 같은 일부 서비스 관리자에 대해 PIDFILE 변수를 설정합니다. 이는 그들이 pid-file 의 생성 및 콘텐츠를 처리하기 때문입니다.

사용자 및 런타임 모드 변경

Linux 에이전트는 기본적으로 root 으로 실행되지만 더 적은 권한 PRIVILEGED 및 UNPRIVILEGED )을 가진 사용자의 실행도 지원합니다. 자세한 내용 은 에이전트 실행 모드에 대한 설명서를 참조하십시오.

중요

에이전트를 루트가 아닌 사용자( PRIVILEGED 또는 UNPRIVILEGED )로 실행하려면 tarball에 제공된 폴더 및 파일에 대한 읽기/쓰기 액세스 권한을 부여해야 합니다.

실행 모드를 변경하려면:

서비스 스크립트를 편집합니다.
서비스 스크립트 ./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.service 을(를) 엽니다.
[Service] 행을 검색합니다.
User=user_name 줄을 추가하고 user_name 을 에이전트를 실행할 사용자( PRIVILEGED 또는 UNPRIVILEGED )로 바꿉니다.
파일을 저장합니다.
서비스 스크립트 ./newrelic-infra/etc/init_scripts/sysv/newrelic-infra 을(를) 엽니다.
USER=root 행을 검색합니다.
root 을 에이전트를 실행할 사용자( PRIVILEGED 또는 UNPRIVILEGED )로 바꿉니다.
파일을 저장합니다.
서비스 스크립트 ./newrelic-infra/etc/init_scripts/upstart/newrelic-infra 을(를) 엽니다.
exec /usr/bin/newrelic-infra 행을 검색합니다.
exec su -s /bin/sh -c ‘exec “$0” “$@“’ user_name-- /usr/bin/newrelic-infra 으로 바꿉니다.
user_name 을 에이전트를 실행할 사용자( PRIVILEGED 또는 UNPRIVILEGED )로 바꿉니다.
파일을 저장합니다.
에이전트를 PRIVILEGED 으로 실행하는 경우 두 가지 추가 Linux 기능을 제공해야 합니다.
1. libcap 라이브러리가 호스트에 설치되어 있는지 확인하십시오. (함께 제공되는 setcap 및 getcap 명령이 필요합니다.)
2. tarball의 내용을 추출하고 루트 권한으로 다음 명령을 실행합니다.
  bash
```
$setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infra
```
3. 실행 모드는 현재 사용자와 할당된 커널 기능을 기반으로 선택됩니다.

플러그인 디렉토리 구성

인프라 에이전트를 사용하면 Kubernetes, AWS, MySQL, Redis, Kafka 등과 같은 널리 사용되는 서비스의 데이터를 모니터링하고 보고하는 통합 을 설치할 수 있습니다. 각 통합에는 기본적으로 이름이 integration-name-config.yml 인 자체 구성 파일이 사전 정의된 위치에 배치됩니다. /etc/newrelic-infra/integrations.d/ . 초기화 시 에이전트는 구성 파일을 로드합니다.

통합 구성 파일의 미리 정의된 위치를 덮어쓰려면 다음 방법 중 하나를 사용합니다.

NRIA_PLUGIN_DIR 환경 변수에서 위치를 설정합니다.
plugin_dir 필드를 사용하여 newrelic-infra.yml 구성 파일에서 사용자 정의 경로를 설정합니다.
newrelic-infra 바이너리를 실행할 때 -plugin_dir 을 사용하여 명령줄 인수로 전달합니다.

에이전트 디렉터리 구성

에이전트는 설치된 통합 , 캐싱 데이터(인벤토리) 등을 실행하기 위해 자체 정의된 디렉토리가 필요합니다. 기본 위치는 /var/db/newrelic-infra/ 입니다.

에이전트 디렉터리의 구조와 내용은 다음과 같습니다.

LICENSE: New Relic 인프라 에이전트 라이선스가 포함된 텍스트 파일입니다.
custom-integrations: 설치된 사용자 정의 통합 을 저장하는 디렉토리.
newrelic-integrations: New Relic 공식 통합 을 저장하는 디렉토리.
data: 에이전트가 캐시 데이터(인벤토리)를 저장하는 디렉터리입니다.

중요

에이전트를 실행하는 사용자는 에이전트 디렉터리에 대한 읽기/쓰기 권한이 있어야 합니다.

에이전트 디렉터리의 미리 정의된 위치를 덮어쓰려면 다음 방법 중 하나를 사용합니다.

NRIA_AGENT_DIR 환경 변수에서 위치를 설정합니다.
agent_dir 필드를 사용하여 newrelic-infra.yml 구성 파일에서 사용자 정의 경로를 설정합니다.
newrelic-infra 바이너리를 실행할 때 -agent_dir 을 사용하여 명령줄 인수로 전달합니다.

로그 파일 구성

기본적으로 에이전트는 /var/db/newrelic-infra/newrelic-infra.log 에 로그 파일을 저장합니다.

중요

에이전트를 실행하는 사용자는 로그 파일에 대한 쓰기 권한이 있어야 합니다.

로그 파일의 미리 정의된 위치를 덮어쓰려면 다음 방법 중 하나를 사용합니다.

NRIA_LOG_FILE 환경 변수에서 위치를 설정합니다.
log_file 필드를 사용하여 newrelic-infra.yml 구성 파일에서 사용자 정의 경로를 설정합니다.
newrelic-infra 바이너리를 실행할 때 -log_file 을 사용하여 명령줄 인수로 전달합니다.

에이전트 바이너리 위치 변경

실행 파일의 위치를 변경하려면 서비스 스크립트를 편집하십시오.

다음은 뭐지?

다음을 수행할 수도 있습니다.

인프라 데이터에 주석을 달기 위해 사용자 정의 속성 을 추가하십시오.
서버가 Amazon EC2에서 호스팅되는 경우 AWS 계정을 연결하십시오 .
로그 전달 을 활성화합니다.
Flex 실행 파일을 수동으로 추가하여 Flex 통합을 활성화합니다.
다른 인프라 통합 을 추가하여 외부 서비스에서 데이터를 수집합니다.
수동 으로 시작, 중지, 다시 시작하거나 에이전트 상태를 확인합니다 .

사용자의 편의를 위해 제공되는 기계 번역입니다.

Linux용 인프라 에이전트 Tarball 수동 설치

주의

에이전트 설치

설치: 선택적 단계

이 문서가 설치하는데 도움이 되셨나요?

서비스 스크립트 설치

중요

서비스 관리자 결정

팁

중요

시스템화

시스템

건방진 녀석

구성 파일의 위치 변경

시스템화

시스템

건방진 녀석

pid 파일 위치 변경

중요

에이전트가 pid 파일을 생성하는 경우

중요

에이전트가 PIDFILE 환경 변수를 사용하는 경우

주의

팁

사용자 및 런타임 모드 변경

중요

시스템화

시스템

건방진 녀석

플러그인 디렉토리 구성

에이전트 디렉터리 구성

중요

로그 파일 구성

중요

에이전트 바이너리 위치 변경

시스템화

시스템

건방진 녀석

다음은 뭐지?

사용자의 편의를 위해 제공되는 기계 번역입니다.

Linux용 인프라 에이전트 Tarball 수동 설치

주의

에이전트 설치 .css-21sua1{background:none;border:none;width:0;padding:0;}

설치: 선택적 단계

이 문서가 설치하는데 도움이 되셨나요?

서비스 스크립트 설치

중요

중요

시스템화

시스템

건방진 녀석

구성 파일의 위치 변경

시스템화

시스템

건방진 녀석

pid 파일 위치 변경

중요

에이전트가 pid 파일을 생성하는 경우

에이전트가 PIDFILE 환경 변수를 사용하는 경우

사용자 및 런타임 모드 변경

중요

시스템화

시스템

건방진 녀석

플러그인 디렉토리 구성

에이전트 디렉터리 구성

중요

로그 파일 구성

중요

에이전트 바이너리 위치 변경

시스템화

시스템

건방진 녀석

다음은 뭐지?

에이전트 설치