New Relic CLI 시작하기

New Relic CLI 설치

아래 설명된 대로 운영 체제에 맞는 New Relic CLI를 다운로드합니다. 또한 .deb 및 .rpm을 포함하여 모든 플랫폼용으로 미리 빌드된 바이너리를 다운로드할 수 있습니다. 패키지 및 Windows x64 .msi 설치 프로그램.

Linux

Snapcraft를사용하여 다음을 실행합니다.

$
sudo snap install newrelic-cli

맥 OS

Homebrew를사용하여 다음을 실행합니다.

$
brew install newrelic-cli

윈도우

Scoop 을사용하여 다음을 실행합니다.

$
scoop bucket add newrelic-cli https://github.com/newrelic/newrelic-cli.git
$
scoop install newrelic-cli

New Relic CLI 프로필 생성

New Relic CLI를 설치한 후 첫 번째 프로필을 생성할 차례입니다. 프로필에는 모든 CLI 명령에 적용할 수 있는 자격 증명 및 설정이 포함되어 있어 계정 간에 전환할 때 유용합니다.

profiles add 명령을 실행합니다.

$
# Create the tutorial account for the US region
$
newrelic profiles add --profile tutorial --apiKey YOUR_NEW_RELIC_USER_KEY -r YOUR_REGION
$
# Set the profile as defaults
$
newrelic profiles default --profile tutorial

신청서 세부정보 확인

이제 New Relic으로 계측한 애플리케이션에 태그를 추가하세요. 태그는 엔터티를 구성하고 필터링하는 데 도움이 되는 키-값 쌍입니다. 엔터티 (예: 애플리케이션)에는 최대 100개의 키-값 쌍이 연결될 수 있습니다.

New Relic CLI를 사용하여 애플리케이션을 검색하기 전에 New Relic에서 계정 ID 와 애플리케이션 이름을 적거나 복사하세요. New Relic 플랫폼에서 애플리케이션을 찾으려면 두 가지가 모두 필요합니다.

애플리케이션 세부정보를 JSON 객체로 검색하세요.

APM 애플리케이션을 검색하려면 apm application search 명령을 사용합니다.

$
newrelic apm application search --accountId YOUR_ACCOUNT_ID --name NAME_OF_YOUR_APP

guid 값 찾기

계정 ID가 유효하고 계정에 애플리케이션 이름이 있는 경우 apm application search 다음 예와 유사한 데이터를 생성합니다.

[
  {
    "accountId": YOUR_ACCOUNT_ID,
    "applicationId": YOUR_APP_ID,
    "domain": "APM",
    "entityType": "APM_APPLICATION_ENTITY",
    "guid": "A_LONG_GUID",
    "name": "NAME_OF_YOUR_APP",
    "permalink": "https://one.newrelic.com/redirect/entity/A_LONG_GUID",
    "reporting": true,
    "type": "APPLICATION"
  }
]

애플리케이션을 성공적으로 검색했으면 guid 값을 찾습니다. 애플리케이션의 고유 식별자입니다. 복사하거나 적어 두어야 합니다.

애플리케이션에 간단한 태그 추가

이제 GUID가 있으므로 애플리케이션에서 직접 New Relic CLI를 가리킬 수 있습니다. 태그를 추가하는 것은 CLI 기능을 시험해 볼 수 있는 가장 간단한 방법입니다(걱정하지 마세요. 태그는 entity tags delete사용하여 삭제할 수 있습니다).

여기에서 애플리케이션에 환경 태그를 추가합니다. entities tags create 명령을 사용하여 애플리케이션에 dev:testing 태그⁠(또는 다른 키-값 쌍)를 추가합니다.

$
newrelic entity tags create --guid YOUR_APP_GUID --tag devkit:testing

태그 세트 추가

여러 태그를 추가하려면 어떻게 해야 합니까? 구출에 태그 세트! 태그는 콜론으로 구분된 키-값 쌍이지만 태그 세트는 쉼표로 구분된 태그 목록입니다. 예를 들어:

tag1:value1,tag2:value2

한 번에 애플리케이션에 여러 태그를 추가하려면 다음 스니펫을 수정하고 실행하십시오.

$
newrelic entity tags create --guid YOUR_APP_GUID --tag tag1:test,tag2:test

애플리케이션의 태그 검색

일부 태그를 생성하고 애플리케이션에 추가했지만 태그가 작동하는지 테스트하려면 태그를 검색해야 합니다.

entity tags get 명령을 실행합니다.

$
newrelic entity tags get --guid YOUR_APP_GUID

애플리케이션과 연결된 모든 태그는 JSON 배열로 검색됩니다.

[
  {
    "Key": "tag1",
    "Values": ["true"]
  },
  {
    "Key": "tag2",
    "Values": ["test"]
  },
  {
    "Key": "tag3",
    "Values": ["testing"]
  }
  // ...
]

보너스 단계: 배포 마커 만들기

애플리케이션 배포가 잘못되는 경우가 많습니다. 배포 마커는 애플리케이션 데이터에 첨부할 때 배포를 추적하고 발생한 문제를 해결하는 데 도움이 되는 레이블입니다.

배포 마커를 만들려면 이전 검색과 동일한 애플리케이션 ID를 사용하여 apm deployment create 명령을 실행합니다.

$
newrelic apm deployment create --applicationId YOUR_APP_ID --revision $(git describe --tags --always)

배포 버전 및 타임스탬프에 대한 JSON 응답을 확인하세요.

이 워크플로를 CI/CD(지속적인 통합) 또는 지속적인 배포(CI/CD) 시스템으로 구축하여 배포 후 애플리케이션 동작의 변경 사항을 나타낼 수 있습니다.

다음은 예입니다.

{
  "id": 37075986,
  "links": {
    "application": 204261368
  },
  "revision": "v1.2.4",
  "timestamp": "2020-03-04T15:11:44-08:00",
  "user": "Developer Toolkit Test Account"
}