• English日本語한국어
  • 로그인지금 시작하기

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하십시오.

문제 신고

New Relic CLI 시작하기

터미널에서 편안하게 New Relic 플랫폼에 액세스하십시오. New Relic CLI를 사용하여 엔터티 태그를 관리하고, 워크로드를 정의하고, 배포 마커를 기록하는 등의 작업을 수행할 수 있습니다. 즉, CLI를 사용하여 DevOps 워크플로에서 일반적인 작업을 자동화할 수 있습니다. 이 가이드는 설치 및 구성에서 기본 사용에 이르기까지 New Relic CLI의 필수 요소를 안내합니다.

시작하기 전에

이 안내서에는 다음이 필요합니다.

New Relic CLI 설치

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

Linux

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

bash
$
sudo snap install newrelic-cli

맥 OS

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

bash
$
brew install newrelic-cli

윈도우

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

bash
$
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 명령을 실행합니다.

bash
$
# 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

중요

뉴렐릭 계정의 지역을 설정해야 합니다. -r 사용하여 us 또는 eu 설정합니다.

신청서 세부정보 확인

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

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

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

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

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

오류가 발생하면 계정 ID와 애플리케이션 이름이 올바른지 확인하세요.

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 태그⁠(또는 다른 키-값 쌍)를 추가합니다.

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

태그 세트 추가

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

tag1:value1,tag2:value2

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

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

중요

태그 추가는 비동기 작업입니다. 즉, 태그가 생성되는 데 시간이 걸릴 수 있습니다.

애플리케이션의 태그 검색

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

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

bash
$
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 명령을 실행합니다.

bash
$
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"
}

다음 단계

New Relic CLI에서 사용 가능한 모든 명령을 살펴보세요. 예를 들어, 사용하여 New Relic 워크플로를 생성할 수 있습니다.workload create

다른 커뮤니티 구성원과 교류하려면 New Relic Explorers Hub 페이지를 방문하세요. GitHub의 기능 요청 또는 버그 보고서를 환영합니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.