ECS-DD-TRACE

ECS 에서만 사용할 수 있는 Node.js Datadog Monitoring Library 입니다.

지원하는 기능은 APM 측정과 Metric 측정입니다.

Install

Dependency 에 추가해주세요.

1$ npm install @titicaca/ecs-dd-trace

APM

APM 기능은 node.js 가 시작할 때 start script 에 넣어주면 자동으로 APM 을 수집합니다.

ENABLE_DD_APM 환경 변수에 true 를 넣어줍니다.

package.json 의 scripts 를 수정해 줍니다. --require @titicaca/ecs-dd-trace

1{
2  "scripts": {
3    "start": "NODE_ENV=production node --require @titicaca/ecs-dd-trace dist"
4  }
5}

PREVENT_PARAMETERIZED_ROUTE_PATH

PREVENT_PARAMETERIZED_ROUTE_PATH 환경 변수에 true 를 넣어줄 경우 동작합니다.

GET /users/{user_id} 와 같이 dynamic path routing API 를 사용할 경우 Datadog APM 에서는 통일된 API로 처리하지만 이것을 분리하여 보여주고 싶은 요구사항을 해결할 때 사용합니다.

Metric

Metric 은 원하는 지표를 카운트 할 수 있는 기능입니다.

ENABLE_DD_METRIC 환경 변수에 true 를 넣어줍니다.

사용법

1const metricClient = await MetricClient.init()
2await increaseMetricCount('campaign_api.test')

환경 변수

ECS 에서 동작하는 모든 컨테이너에는 ECS_CONTAINER_METADATA_URI_V4 환경 변수가 있습니다.