사용자가 Nerdlet에 액세스하는 한 가지 방법은 실행 프로그램을 만드는 것입니다. 런처는 뉴렐릭의 Apps [앱] 페이지에서 Nerdlet을 엽니다. 귀하의 계정에 있는 엔터티 에서 Nerdlet에 대한 액세스를 제공할 수도 있습니다.
이 가이드에서는 Nerdlet을 엔터티에 연결하는 방법을 배웁니다.
시작하기 전에
아직 하지 않은 경우:
- New Relic 계정에가입하세요
- 뉴렐릭 One CLI 설치 및 구성
Nerdpack 만들기
CLI를 업데이트하세요.
$nr1 update
CLI를 사용하여 Nerdpack을 생성합니다.
$nr1 create --type nerdpack --name entity-nerdlet
그 결과 entity-nerdlet-launcher
이라는 실행 프로그램과 entity-nerdlet-nerdlet
이라는 Nerdlet으로 구성된 entity-nerdlet
이라는 Nerdpack이 생성됩니다.
Nerdpack을 제공하세요:
$cd entity-nerdlet$nr1 nerdpack:serve
https://one.newrelic.com/?nerdpacks=local 로 이동하여 Apps 로 이동합니다.
?nerdpacks=local
로컬에서 제공되는 Nerdpack을 뉴렐릭에 로드하려면 필요합니다.
Your apps [귀하의 앱] 아래에서 런처를 클릭하여 뉴쿨릭 제작을 확인하세요.
Nerdlet을 엔터티에 연결
런처에서 Nerdlet에 액세스하는 방법을 살펴보았습니다. 이제 엔터티에서 Nerdlet에 액세스하세요.
Nerdpack의 제한리 내부에서 nerdlets/entity-nerdlet-nerdlet/nr1.json
엽니다. 이것은 Nerdlet의 메타데이터 파일입니다. 이 파일을 사용하여 Nerdlet을 엔터티에 첨부합니다.
entities
을 포함하는 context
객체를 추가하세요.
{ "schemaType": "NERDLET", "id": "entity-nerdlet-nerdlet", "displayName": "EntityNerdletNerdlet", "description": "", "context": { "entities": [] }}
이는 뉴렐릭에게 귀하의 Nerdlet을 엔터티 컨텍스트에 포함시키려는 것을 알려줍니다.
엔터티 컨텍스트를 추가합니다.
{ "schemaType": "NERDLET", "id": "entity-nerdlet-nerdlet", "displayName": "EntityNerdletNerdlet", "description": "", "context": { "entities": [ { "domain": "APM", "type": "APPLICATION" } ] }}
여기서는 APM 도메인의 모든 애플리케이션 엔터티에 Nerdlet을 연결했습니다.
APM 으로 이동합니다.
Nerdpack을 로컬로 제공하고 있으므로 여전히 ?nerdpacks=local
쿼리 문자열을 지정해야 한다는 점을 기억하세요.
원하는 애플리케이션을 선택하세요.
아래로 스크롤하여 특별에 연결된 Nerdlet을 확인하세요.
이 메뉴 옵션을 클릭하면 실행 프로그램에서와 동일한 방식으로 Nerdlet을 볼 수 있습니다.
구성하세요 entities
Nerdlet의 nr1.json
파일에 있는 context.entities
키는 Nerdlet이 연결되어야 하는 엔터티를 지정합니다.
엔터티 지정 domain
domain
를 다음 값 중 하나로 지정하여 Nerdlet을 특정 엔터티 도메인에 연결합니다.
APM
: 애플리케이션 성능 모니터링BROWSER
: 브라우저INFRA
: 인프라 모니터링MOBILE
: 모바일 모니터링SYNTH
: 신세틱영상
예를 들어 Nerdlet을 APM
도메인의 모든 엔터티에 연결합니다.
{ "context": { "entities": [{ "domain": "APM" }] }}
도메인에 있는 엔터티를 제외한 모든 엔터티에 Nerdlet을 연결하세요.
{ "context": { "entities": [{ "domain": "!APM" }] }}
여러 도메인의 모든 엔터티에 Nerdlet을 연결하세요.
{ "context": { "entities": [{ "domain": "APM" }, { "domain": "BROWSER" }] }}
엔터티 지정 type
type
를 다음 값 중 하나로 지정하여 Nerdlet을 특정 엔터티 유형에 연결합니다.
APPLICATION
HOST
MONITOR
예를 들어 Nerdlet을 APPLICATION
유형의 모든 엔터티에 연결합니다.
{ "context": { "entities": [{ "type": "APPLICATION" }] }}
지정된 유형을 제외한 모든 엔터티에 Nerdlet을 연결합니다.
{ "context": { "entities": [{ "type": "!APPLICATION" }] }}
유형이 다음 유형 중 하나와 일치하는 모든 엔터티에 Nerdlet을 첨부하세요.
{ "context": { "entities": [{ "type": "APPLICATION" }, { "type": "MONITOR" }] }}
엔터티 지정 tags
주어진 태그가 있는 엔터티에 Nerdlet을 연결합니다.
예를 들어, 특정 GUID가 있는 엔터티에 Nerdlet을 연결합니다.
{ "context": { "entities": [ { "tags": [ { "key": "guid", "values": ["<SOME ENTITY GUID>"] } ] } ] }}
특정 accountId
있고 Python 프로그래밍 언어를 사용하는 모든 엔터티에 Nerdlet을 연결합니다.
{ "context": { "entities": [ { "tags": [ { "key": "accountId", "values": ["<SOME ACCOUNT ID>"] }, { "key": "language", "values": ["python"] } ] } ] }}
필터 결합
Nerdlet이 추가될 엔터티를 필터링할 때 domain
, type
및 tags
결합할 수 있습니다.
{ "context": { "entities": [ { "domain": "APM", "type": "APPLICATION", "tags": [ { "key": "language", "values": ["python"] } ] }, { "domain": "SYNTH", "type": "MONITOR" }, { "domain": "BROWSER" } ] }}
이 예에서는 Nerdlet을 다음에 연결했습니다.
- 메타데이터 태그가
python
언어를 지정하는 모든 APM 애플리케이션 - AND all 신세틱스 모니터
- AND 모든 브라우저 엔터티