Docker 및 기타 컨테이너 환경: PHP 에이전트 설치

Docker 컨테이너 또는 기타 컨테이너에 PHP 에이전트를 설치하여 하나 이상의 PHP 애플리케이션을 모니터링할 수 있습니다. 이는 표준 PHP 에이전트 호환성 및 요구 사항을 충족하는 컨테이너에 대해 지원됩니다.

컨테이너 옵션

PHP 에이전트가 작동하려면 PHP 에이전트(각 애플리케이션에 하나씩)와 하나 이상의 에이전트에서 보낸 데이터를 집계하여 New Relic으로 보내는 데몬 이라는 두 가지 구성 요소가 필요합니다. 이러한 이유로 컨테이너 환경에 PHP 에이전트를 활성화하기 위한 두 가지 옵션이 있습니다.

• 다른 컨테이너에 에이전트와 데몬을 설치합니다. 권장하는 설정입니다.
• 동일한 컨테이너에 에이전트와 데몬을 설치합니다. 이는 컨테이너 수를 줄이려는 경우에 유용할 수 있습니다.

다른 컨테이너에 에이전트와 데몬 설치

에이전트와 데몬을 다른 컨테이너에 설치하는 것은 뉴렐릭 PHP 에이전트 릴리스 9.2.0부터 지원됩니다.

예제 애플리케이션을 보려면 New Relic의 지원 포럼 으로 이동하세요. 수명이 짧은 애플리케이션 컨테이너를 사용하는 경우 PHP 에이전트 데몬에 대해 별도의 컨테이너를 사용하는 것이 좋습니다.

데몬 컨테이너 설정

Docker를 사용하는 경우 Docker Hub 에서 데몬 이미지를 가져올 수 있습니다.

1. 다음 명령을 실행합니다. docker pull newrelic/php-daemon .
2. 이미지를 사용자 지정하려면 Docker Hub 의 단계를 따르세요.

고유한 데몬 이미지를 빌드할 수도 있습니다.

1. 데몬을 설치하려면 New Relic의 tar 파일 다운로드 사이트 에서 PHP 에이전트 패키지를 다운로드하고 install_daemon 인수와 함께 newrelic-install 스크립트를 실행합니다.
2. --address 및 --watchdog-foreground 인수를 사용하여 데몬을 시작합니다.

--address 인수는 데몬이 연결을 수락할 포트를 설정합니다. --watchdog-foreground 인수는 데몬이 포그라운드에서 실행되도록 합니다.

PHP 에이전트 컨테이너 설정

Docker용 PHP 에이전트 컨테이너를 설정하려면:

1. 컨테이너에 PHP 설치가 가능한지 확인하세요. 예를 들어 php php:fpm 또는 와 같은 php:cli 에 대해 Docker '공식 이미지'를 사용하세요.
2. 에이전트를 설치하려면 뉴렐릭 다운로드 사이트 에서 PHP 에이전트 패키지를 다운로드하고 install 인수와 함께 newrelic-install 펼쳐를 실행하세요.
3. newrelic.ini 파일에서 newrelic.appname 및 newrelic.license 항목을 사용하여 애플리케이션 이름과 라이선스 키설정합니다.
4. newrelic.ini 파일에서 newrelic.daemon.address 옵션을 설정하여 에이전트가 데몬을 가리키도록 합니다. 이 옵션의 값이 HOST:PORT 인지 확인하십시오. 여기서 HOST 은 데몬이 실행 중인 호스트의 이름 또는 IP 주소이고 PORT 는 데몬이 수신 대기하는 포트 번호입니다.

동일한 컨테이너에 에이전트와 데몬 설치

동일한 Docker 컨테이너에서 PHP 에이전트와 데몬을 설정하려면:

1. 컨테이너에 PHP 설치가 가능한지 확인하세요. 예를 들어 php php:fpm 또는 와 같은 php:cli 에 대해 Docker '공식 이미지'를 사용하세요.
2. 에이전트를 설치하려면 뉴렐릭 다운로드 사이트 에서 PHP 에이전트 패키지를 다운로드하고 install 인수와 함께 newrelic-install 파일을 실행하세요.
3. newrelic.ini 파일의 newrelic.license 및 newrelic.appname 항목을 통해 애플리케이션 이름과 라이선스 키설정합니다.

FROM php:fpm

# Install the latest New Relic PHP Agent
RUN \
    cd /tmp \
    # Discover the latest released version:
    && export NEW_RELIC_AGENT_VERSION=$(curl -s https://download.newrelic.com/php_agent/release/ | grep -o '[1-9][0-9]\?\(\.[0-9]\+\)\{3\}' | head -n1) \
    # Discover libc provider
    && export NR_INSTALL_PLATFORM=$(ldd --version 2>&1 | grep -q musl && echo "linux-musl" || echo "linux") \
    # Download the discovered version:
    && curl -o newrelic-php-agent.tar.gz https://download.newrelic.com/php_agent/release/newrelic-php5-${NEW_RELIC_AGENT_VERSION}-${NR_INSTALL_PLATFORM}.tar.gz \
    # Install the downloaded agent:
    && tar xzf newrelic-php-agent.tar.gz \
    && NR_INSTALL_USE_CP_NOT_LN=1 NR_INSTALL_SILENT=0 ./*/newrelic-install install \
    # Configure the agent to use license key from NEW_RELIC_LICENSE_KEY env var:
    && sed -ie 's/[ ;]*newrelic.license[[:space:]]=.*/newrelic.license=${NEW_RELIC_LICENSE_KEY}/' $(php-config --ini-dir)/newrelic.ini \
    # Configure the agent to use app name from NEW_RELIC_APP_NAME env var:
    && sed -ie 's/[ ;]*newrelic.appname[[:space:]]=.*/newrelic.appname=${NEW_RELIC_APP_NAME}/' $(php-config --ini-dir)/newrelic.ini \
    # Cleanup temporary files:
    && rm newrelic-php-agent.tar.gz && rm -rf newrelic-php5-*-linux