Heroku의 스트림 로그

귀하의 로그인 데이터가 이미 Heroku 의 내장 Logplex 라우터에 의해 모니터링되고 있는 경우 통합을 사용하여 뉴렐릭에서 귀하의 로그인 데이터를 전달하고 강화할 수 있습니다.

Heroku 로그를 뉴렐릭으로 전달하면 로그 데이터에 대한 향상된 로그 관리수집, 처리, 탐색, 쿼리 및 공지 기능이 제공됩니다.

현재 Heroku HTTPS 드레이닝 과 Heroku Syslog 드레이닝을 지원합니다.

Heroku HTTPS 드레이닝을 사용하면 로그에 사용자 정의 메타데이터를 추가할 수 있습니다. 이렇게 하면 건축 이름이나 필요한 기타 속성과 같은 각 배수구에 대해 서로 다른 속성을 설정할 수 있습니다. 또한 새로운 드레인을 등록하고 삭제하는 전체 과정이 syslog보다 더 쉽습니다.

상대방의 Heroku Syslog 드레이닝은 이 사용자 정의 메타데이터를 추가하는 것을 허용하지 않으므로 로그에 구성된 드레이닝을 구별하기가 더 어렵습니다.

Heroku HTTPS 배수

이 유형의 배수를 구성하려면:

1. 관리자 역할이 있는지 확인하세요.

2. 뉴렐릭 마켓플레이스 로 이동합니다.

3. Logging

   아래에서 Heroku 타일을 클릭합니다. 검색창을 이용해 검색하실 수도 있습니다.

4. 계정이 여러 개인 경우 로그를 보낼 계정을 선택하세요.

5. 선택사항: 로그 드레이닝에 커스텀 메타데이터를 추가하고 필요한 키 쌍으로 목록을 채우려면

   Add metadata

   클릭합니다.

6. 애플리케이션에 이름을 지정하세요. 나중에 데이터를 찾는 데 사용됩니다.

7. Copy to clipboard

   버튼을 클릭하여 Heroku CLI 명령을 클립보드에 복사합니다.

8. Heroku CLI가 설정된 디렉터리의 터미널로 이동합니다. Windows VM을 사용하는 경우 Git Bash 대신 기존 명령 프롬프트를 사용하세요.

9. 터미널에서 명령을 실행하십시오.

10. 선택사항: 로그인이 뉴렐릭에 도달했는지 확인하려면

    Test for logs

    클릭하세요.

Heroku Syslog 배수

Heroku HTTPS 드레이닝은 설치 및 제거가 간편하고 사용자 정의 속성을 로그인에 추가할 수 있으므로 가능하면 사용하는 것이 좋습니다.

Heroku Syslog 드레인 생성

Heroku HTTPS 드레이닝은 설정이 간단하고 로그에 속성을 추가할 수 있으므로 사용하는 것이 좋습니다. 그러나 syslog 드레이닝을 사용해야 하는 경우 절차는 다음과 같습니다.

1. 관리자 역할이 있는지 확인하세요.

2. Heroku CLI 를 다운로드하여 설치합니다.

3. Heroku CLI를 사용하여 Syslog 드레이닝을 생성하고 이를 로그를 스트리밍하려는 애플리케이션에 연결하고 YOUR_APP_NAME Heroku 애플리케이션의 이름으로 바꿉니다.

   bash

   카피

   $
   heroku drains:add syslog+tls://newrelic.syslog.nr-data.net:6515 -a YOUR_APP_NAME

   유럽에 거주하는 경우 대신 다음 명령을 실행하세요.

   bash

   카피

   $
   heroku drains:add syslog+tls://newrelic.syslog.eu.nr-data.net:6515 -a YOUR_APP_NAME

4. 다음 명령을 실행하고 token 속성에서 Heroku Syslog 배수 토큰을 복사합니다.

   bash

   카피

   $
   heroku drains -a YOUR_APP_NAME --json

   {
     "addon": null,
     "created_at": "2018-12-04T00:59:46Z",
     "id": "906262a4-e151-45d2-b35a-a2dc0ea9e688",
     "token": "d.f14da5dc-106b-468d-b1bd-bed0ed9fa1e7",
     "updated_at": "2018-12-04T00:59:47Z",
     "url": "syslog+tls://newrelic.syslog.nr-data.net:6515"
   }

   카피

Heroku syslog 드레이닝 등록

다음으로 New Relic에 새로 생성된 Heroku Syslog 드레인을 등록해야 합니다.

1. 관리자 역할이 있는지 확인하세요.

2. 뉴렐릭 마켓플레이스 로 이동합니다.

3. Logging

   아래에서 Heroku (syslog) 타일을 클릭합니다. 검색창을 이용해 검색하실 수도 있습니다.

4. 계정이 여러 개인 경우 배수 토큰을 등록하려는 계정을 선택하세요.

5. 새로 생성된 Heroku 배수 토큰을

   Heroku drain token

   필드에 붙여넣습니다.

6. 등록을 완료하려면

   Add Heroku drain log

   클릭하세요.

Heroku syslog 드레이닝 토큰 매핑 삭제

Heroku 뉴렐릭 UI 또는 통해 syslog 드레이닝 매핑 매핑을 삭제할 수 API 있습니다.

UI를 통해 Heroku syslog 드레이닝 토큰 매핑을 삭제하려면 다음 안내를 따르세요.

1. 관리자 역할이 있는지 확인하세요.

2. 뉴렐릭 마켓플레이스 로 이동합니다.

3. Logging

   아래에서 Heroku (syslog) 타일을 클릭합니다. 검색창을 이용해 검색하실 수도 있습니다.

4. 계정이 여러 개인 경우 삭제하려는 배수 토큰 매핑이 포함된 계정을 선택하고

   Continue

   클릭합니다. 그렇지 않으면 6단계로 이동하세요.

5. 삭제하려는 배수 토큰 매핑을 찾아 옆에 있는 수직 점 3개 아이콘을 클릭하세요. 다음으로

   Delete Heroku drain token

   클릭합니다.

6. Heroku 배수 토큰 매핑이 삭제되었습니다.

REST API를 통해 Heroku syslog 드레이닝 토큰 매핑을 삭제하려면 다음 안내를 따르세요.

1. 사용자 키을 찾거나 생성합니다.

2. 아래 명령을 실행하여 뉴렐릭 계정에서 Heroku 드레인 대상 매핑 목록을 검색하고 YOUR_NR_LICENSE_KEY 및 YOUR_NR_ACCOUNT_ID 값을 업데이트했는지 확인하세요.

   bash

   카피

   $
   curl -H 'api-key: YOUR_NR_LICENSE_KEY' https://log-syslog-configuration-api.service.newrelic.com/heroku-account-mappings?accountId=YOUR_NR_ACCOUNT_ID

   형식화된 결과는 다음과 같습니다.

   [
     {
       "herokuMappingId": 1549,
       "drainToken": "YOUR_DRAIN_TOKEN",
       "nrApiInsertKey": "YOUR_DRAIN_TOKEN_NR_API_KEY",
       "createdAt": "2022-05-13T07:47:23",
       "createdBy": "YOUR_EMAIL_ADDRESS"
     }
   ]

   카피

   제거하려는 각 배수 토큰에 대해 herokuMappingId 필요합니다.

3. 배수 토큰을 삭제하려면 아래 명령을 실행하세요. 마지막 단계에서 검색한 YOUR_NR_LICENSE_KEY, YOUR_NR_ACCOUNT_ID 및 herokuMappingId 의 값을 업데이트해야 합니다.

   bash

   카피

   $
   curl -X DELETE -H 'api-key: YOUR_NR_LICENSE_KEY' https://log-syslog-configuration-api.service.newrelic.com/heroku-account-mappings/<herokuMappingId>?accountId=YOUR_NR_ACCOUNT_ID

완료되면 API가 HTTP 204 응답을 반환하고 배수 토큰 매핑이 삭제됩니다.

로그 데이터 보기

모든 것이 올바르게 구성되고 데이터가 수집되는 경우 다음 두 위치에서 데이터 로그가 표시되어야 합니다.

• 로그 UI
• NRQL 조회를 실행하는 새 도구. 예를 들어, 다음과 같은 쿼리를 실행할 수 있습니다.

SELECT * FROM Log

로그 관리 기능을 활성화한 후에도 데이터가 나타나지 않으면 표준 로그 문제 해결 절차 를 따르십시오.

다음은 뭐지?

• 로그 UI를 사용하여 플랫폼 전체의 로깅 데이터를 탐색해 보세요.
• 컨텍스트에서 로그 기능을 사용하여 로그를 전달하여 애플리케이션 및 플랫폼 성능 데이터 모두에 대한 가시성을 확보하십시오.
• 경보를 설정하십시오.
• 데이터를 조회 하고 대시보드를 작성하십시오.

로그 전달 사용 안함

로그 전달 기능을 비활성화하려면 Heroku Syslog 설명서 의 표준 절차를 따르십시오. New Relic에서는 다른 작업을 수행할 필요가 없습니다.