[typescript] AWS SDK를 사용하여 타입스크립트로 CloudWatch 모니터링 및 로깅 구성하기

26 Dec 2023

typescript

AWS SDK를 사용하여 타입스크립트로 CloudWatch 모니터링 및 로깅을 구성하는 방법을 소개합니다. CloudWatch는 AWS 리소스와 애플리케이션의 모니터링, 로깅 및 경보 생성을 지원합니다. 이를 통해 리소스 상태를 실시간으로 파악하고 필요한 조치를 취할 수 있습니다.

1. AWS SDK 설치

먼저 AWS SDK를 설치해야 합니다. 타입스크립트 프로젝트에서 아래 명령어로 AWS SDK를 설치할 수 있습니다.

npm install aws-sdk

2. CloudWatch 모니터링 설정

2.1 CloudWatch 클라이언트 생성

CloudWatch를 사용하기 위해 AWS SDK에서 제공하는 CloudWatch 클라이언트를 생성해야 합니다. 아래는 클라이언트를 생성하는 예시 코드입니다.

import { CloudWatch } from 'aws-sdk';

const cloudwatch = new CloudWatch({ region: 'your-region' });

2.2 메트릭 및 경보 설정

이제 CloudWatch 클라이언트를 사용하여 메트릭을 생성하고 경보를 설정할 수 있습니다. 예를 들어, CPU 사용률을 모니터링하고 이를 기반으로 경보를 생성하는 방법은 다음과 같습니다.

const params = {
  MetricData: [
    {
      MetricName: 'CPUUtilization',
      Dimensions: [
        {
          Name: 'InstanceID',
          Value: 'i-12345678',
        },
      ],
      Unit: 'Percent',
      Value: 70.0,
    },
  ],
  Namespace: 'AWS/EC2',
};

cloudwatch.putMetricData(params, (err, data) => {
  if (err) console.log(err, err.stack);
  else console.log(data);
});

3. CloudWatch 로깅 설정

3.1 로그 그룹 및 스트림 설정

CloudWatch 로그는 로그 그룹과 로그 스트림으로 구성됩니다. 이를 위해 AWS SDK를 사용하여 로그 그룹을 생성하고 로그를 기록할 로그 스트림을 설정합니다.

import { CloudWatchLogs } from 'aws-sdk';

const cloudwatchlogs = new CloudWatchLogs({ region: 'your-region' });

const params = {
  logGroupName: '/example-log-group',
  logStreamName: 'example-log-stream',
};

cloudwatchlogs.createLogStream(params, (err, data) => {
  if (err) console.log(err, err.stack);
  else console.log(data);
});

3.2 로그 이벤트 기록

로깅을 위해 putLogEvents 메서드를 사용하여 로그 이벤트를 기록할 수 있습니다.

const logParams = {
  logEvents: [
    {
      message: 'Example log message',
      timestamp: new Date().getTime(),
    },
  ],
  logGroupName: '/example-log-group',
  logStreamName: 'example-log-stream',
};

cloudwatchlogs.putLogEvents(logParams, (err, data) => {
  if (err) console.log(err, err.stack);
  else console.log(data);
});

결론

이제 위의 단계를 따라하면 타입스크립트로 AWS SDK를 사용하여 CloudWatch 모니터링 및 로깅을 구성할 수 있습니다. 이를 통해 애플리케이션 및 리소스의 상태를 모니터링하고 로그를 기록하여 중요한 정보를 보관할 수 있습니다.

본 문서에서는 AWS SDK의 기본적인 사용법을 안내하였으며, 추가적으로 더 복잡한 기능 및 설정에 대해서는 AWS 공식 문서를 참고하시기 바랍니다.

더 많은 정보는 AWS SDK for JavaScript 공식문서를 참고하세요.