Application Insights를 사용하여 Node.js 서비스 및 앱 모니터링

아티클
01/31/2024

Application Insights는 배포 후에 구성 요소를 모니터링하여 성능과 기타 문제를 발견합니다. 데이터 센터, Azure VM 및 웹앱, 다른 퍼블릭 클라우드에서 호스트되는 Node.js 서비스에 Application Insights를 사용할 수 있습니다.

모니터링 데이터를 수신, 저장 및 탐색하려면 코드에 SDK를 포함합니다. 그런 다음 Azure에서 해당 Application Insights 리소스를 설정합니다. SDK는 추가 분석 및 탐색을 위해 해당 리소스로 데이터를 보냅니다.

Node.js 클라이언트 라이브러리는 들어오고 나가는 HTTP 요청, 예외 및 여러 시스템 메트릭을 자동으로 모니터링할 수 있습니다. 0.20 버전부터 클라이언트 라이브러리는 MongoDB, MySQL 및 Redis와 같은 일반적인 타사 패키지 일부를 모니터링할 수 있습니다.

들어오는 HTTP 요청과 관련된 모든 이벤트는 좀 더 빠른 문제 해결을 위해 상호 관계가 지정됩니다.

TelemetryClient API를 사용하여 앱과 시스템의 다양한 측면을 수동으로 계측하고 모니터링 할 수 있습니다. 이 문서의 뒷부분에서 TelemetryClient API에 대해 자세히 설명합니다.

참고 항목

다음 설명서는 Application Insights 클래식 API를 사용합니다. Application Insights에 대한 장기 계획은 OpenTelemetry를 사용하여 데이터를 수집하는 것입니다. 자세한 내용은 .NET, Node.js, Python 및 Java 애플리케이션에 대한 Azure Monitor OpenTelemetry 사용을 참조 하세요.

시작하기

앱 또는 서비스에 대한 모니터링을 설정하려면 다음 작업을 완료합니다.

필수 조건

시작하기 전에 Azure 구독이 있는지 확인하여 없는 경우 무료 계정을 새로 만듭니다. 조직에 이미 Azure 구독이 있는 경우 관리자는 다음 지침에 따라 사용자를 추가할 수 있습니다.

Application Insights 리소스 설정

Azure Portal에 로그인합니다.
Application Insights 리소스를 만듭니다.

참고 항목

2025년 3월 31일에 계측 키 수집에 대한 지원이 종료됩니다. 계측 키 수집은 계속 작동하지만 더 이상 기능에 대한 업데이트 또는 지원을 제공하지 않습니다. 연결 문자열로 전환하여 새로운 기능을 활용합니다.

Node.js 클라이언트 라이브러리 설정

데이터를 수집할 수 있도록 앱에 SDK를 포함합니다.

새 리소스에서 리소스의 연결 문자열을 복사합니다. Application Insights는 연결 문자열을 사용하여 Azure 리소스에 데이터를 매핑합니다. SDK에서 연결 문자열을 사용하려면 먼저 환경 변수 또는 코드에 연결 문자열을 지정해야 합니다.
package.json을 통해 앱의 종속성에 Node.js 클라이언트 라이브러리를 추가합니다. 앱의 루트 폴더에서 다음을 실행합니다.
```
npm install applicationinsights --save
```
참고 항목

TypeScript를 사용하는 경우 별도의 "typings" 패키지를 설치하지 마세요. 이 NPM 패키지에는 기본 제공 입력이 포함되어 있습니다.
코드에서 라이브러리를 명시적으로 로드합니다. SDK는 다른 많은 라이브러리에 계측을 삽입하기 때문에 다른 require 문 앞에도 가능한 한 빨리 라이브러리를 로드합니다.
```
let appInsights = require('applicationinsights');
```
또한 연결 문자열을 setup() 또는 new appInsights.TelemetryClient()에 수동으로 전달하는 대신 APPLICATIONINSIGHTS_CONNECTION_STRING 환경 변수를 통해 제공할 수 있습니다. 이렇게 하면 연결 문자열이 커밋된 소스 코드의 영향을 받지 않고, 다른 환경에 다른 연결 문자열을 지정할 수 있습니다. 수동으로 구성하려면 appInsights.setup('[your connection string]');을 호출합니다.

추가 구성 옵션은 다음 섹션을 참조하세요.

를 설정 appInsights.defaultClient.config.disableAppInsights = true하여 원격 분석을 보내지 않고 SDK를 시도할 수 있습니다.
를 호출 appInsights.start();하여 자동으로 데이터 수집 및 보내기를 시작합니다.

참고 항목

Application Insights 계측 사용의 일환으로 진단 데이터를 수집하여 Microsoft에 보냅니다. 이 데이터는 Application Insights를 실행하고 개선하는 데 도움이 됩니다. 중요하지 않은 데이터 컬렉션을 사용하지 않도록 설정할 수 있는 옵션이 있습니다. 자세히 알아보기.

앱 모니터링

SDK는 Node.js 런타임 및 일부 일반적인 타사 모듈에 대한 원격 분석을 자동으로 수집합니다. 애플리케이션을 사용하여 이 데이터 중 일부를 생성합니다.

그런 다음, Azure Portal에서 이전에 만든 Application Insights 리소스로 이동합니다. 개요 타임라인 처음 몇 가지 데이터 요소를 찾습니다. 더 자세한 데이터를 보려면 차트에서 다른 구성 요소를 선택합니다.

앱에 대해 검색된 토폴로지를 보려면 애플리케이션 맵을 사용합니다.

데이터 없음

SDK는 제출을 위해 데이터를 일괄 처리하므로 항목이 포털에 표시되기까지 지연이 있을 수 있습니다. 리소스에 데이터가 보이지 않으면 다음 해결 방법 중 몇 가지를 시도해 보세요.

애플리케이션을 계속 사용합니다. 더 많은 원격 분석을 생성하기 위해 더 많은 작업을 수행합니다.
포털 리소스 보기에서 새로 고침을 선택합니다. 차트는 주기적으로 자체적으로 새로 고치지만 수동으로 새로 고치면 즉시 새로 고쳐집니다.
필요한 나가는 포트가 열려 있는지 확인합니다.
검색을 사용하여 특정 이벤트를 찾습니다.
FAQ를 확인합니다.

기본 사용법

HTTP 요청, 인기 있는 타사 라이브러리 이벤트, 처리되지 않은 예외 및 시스템 메트릭의 기본 컬렉션의 경우:


let appInsights = require("applicationinsights");
appInsights.setup("[your connection string]").start();

참고 항목

APPLICATIONINSIGHTS_CONNECTION_STRING 환경 변수에 연결 문자열을 설정하는 경우 인수 없이 .setup()를 호출할 수 있습니다. 따라서 환경마다 다른 연결 문자열을 쉽게 사용할 수 있습니다.

다른 패키지를 로드하기 전에 스크립트에서 최대한 빨리 Application Insights 라이브러리 require("applicationinsights")를 로드합니다. 이 단계는 Application Insights 라이브러리에서 나중에 추적하기 위한 패키지를 준비할 수 있도록 하는 데 필요합니다. 비슷하게 준비하는 과정에서 다른 라이브러리와 충돌하는 경우, 충돌이 발생한 후 Application Insights 라이브러리를 로드해 보세요.

JavaScript가 콜백을 처리하는 방식 때문에 외부 종속성과 이후 콜백에서 요청을 추적하려면 추가 작업이 필요합니다. 이 추가 추적은 기본적으로 사용하도록 설정되어 있습니다. SDK 구성 섹션에 설명된 대로 setAutoDependencyCorrelation(false)을 호출하여 사용하지 않도록 설정합니다.

0.22 이전 버전에서 마이그레이션

버전 0.22 이전과 이후 릴리스 간에 호환성이 손상되는 변경이 있습니다. 해당 변경 내용은 다른 Application Insights SDK와의 일관성을 유지하고 향후 확장성을 허용하도록 설계되었습니다.

일반적으로 다음 작업을 통해 마이그레이션할 수 있습니다.

참조를 .로 바꾸기 appInsights.clientappInsights.defaultClient
참조를 .로 바꾸기 appInsights.getClient()new appInsights.TelemetryClient()
client.track* 메서드에 대한 모든 인수를 명명된 속성을 인수로 포함하는 단일 개체로 대체합니다. 각 원격 분석 유형에 대해 제외된 개체는 IDE의 기본 제공 형식 힌트 또는 TelemetryTypes 를 참조하세요.

appInsights.setup()에 연결하지 않고 SDK 구성 함수에 액세스하는 경우 이제 appInsights.Configurations에서 이러한 함수를 찾을 수 있습니다. 예제는 appInsights.Configuration.setAutoCollectDependencies(true)입니다. 다음 섹션에서 기본 구성의 변경 내용을 검토합니다.

SDK 구성

appInsights 개체는 많은 구성 메서드를 제공합니다. 해당 구성 메서드는 다음 코드 조각에 기본값과 함께 나열됩니다.

let appInsights = require("applicationinsights");
appInsights.setup("<connection_string>")
    .setAutoDependencyCorrelation(true)
    .setAutoCollectRequests(true)
    .setAutoCollectPerformance(true, true)
    .setAutoCollectExceptions(true)
    .setAutoCollectDependencies(true)
    .setAutoCollectConsole(true)
    .setUseDiskRetryCaching(true)
    .setSendLiveMetrics(false)
    .setDistributedTracingMode(appInsights.DistributedTracingModes.AI)
    .start();

서비스의 이벤트를 완전히 상호 연결하려면 ..setAutoDependencyCorrelation(true) 이 옵션을 설정하면 SDK는 Node.js 비동기 콜백에서 컨텍스트를 추적할 수 있습니다.

IDE의 기본 제공 형식 힌트 또는 applicationinsights.ts에서 자세한 정보와 선택적 2차 인수에 대한 설명을 검토합니다.

참고 항목

기본적으로 setAutoCollectConsole은 console.log 및 기타 콘솔 메서드에 대한 호출을 제외하도록 구성됩니다. 지원되는 타사 로거(예: winston 및 bunyan)에 대한 호출만 수집됩니다. setAutoCollectConsole(true, true)를 사용하여 console 메서드에 대한 호출을 포함하도록 해당 동작을 변경할 수 있습니다.

샘플링

기본적으로 SDK는 수집된 모든 데이터를 Application Insights 서비스로 보냅니다. 샘플링을 사용하여 데이터의 양을 줄이려면 클라이언트의 config 개체에서 samplingPercentage 필드를 설정합니다. samplingPercentage를 100(기본값)으로 설정하면 모든 데이터가 전송되고, 0으로 설정하면 아무 데이터도 전송되지 않습니다.

자동 상관 관계를 사용하는 경우 단일 요청과 관련된 모든 데이터가 하나의 단위로 포함되거나 제외됩니다.

샘플링을 사용하도록 설정하려면 다음과 같은 코드를 추가합니다.

const appInsights = require("applicationinsights");
appInsights.setup("<connection_string>");
appInsights.defaultClient.config.samplingPercentage = 33; // 33% of all telemetry will be sent to Application Insights
appInsights.start();

다중 구성 요소 애플리케이션을 위한 다중 역할

일부 시나리오에서 애플리케이션은 동일한 연결 문자열로 모두 계측하려는 여러 구성 요소로 구성될 수 있습니다. 별도의 연결 문자열을 사용하는 것처럼 이러한 구성 요소를 포털에서 별도의 단위로 계속 표시하려고 합니다. 예를 들어, 애플리케이션 맵의 개별 노드가 있습니다. Application Insights 리소스에 데이터를 보내는 다른 구성 요소와 한 구성 요소의 원격 분석을 구별하려면 RoleName 필드를 수동으로 구성해야 합니다.

다음 코드를 사용하여 RoleName 필드를 설정합니다.

const appInsights = require("applicationinsights");
appInsights.setup("<connection_string>");
appInsights.defaultClient.context.tags[appInsights.defaultClient.context.keys.cloudRole] = "MyRoleName";
appInsights.start();

브라우저 SDK 로더

참고 항목

공개 미리 보기로 사용할 수 있습니다. Microsoft Azure 미리 보기에 대한 보충 사용 약관

구성에 따라 JavaScript(웹) SDK 로더 스크립트 삽입을 통해 노드 서버에 대해 자동 웹 계측을 사용하도록 설정할 수 있습니다.

let appInsights = require("applicationinsights");
appInsights.setup("<connection_string>")
    .enableWebInstrumentation(true)
    .start();

또는 환경 변수 APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_ENABLED = true를 설정하여.

다음 요구 사항이 모두 충족되면 노드 서버 응답에서 웹 계측이 사용하도록 설정됩니다.

응답의 상태 코드는 200입니다.
응답 방법은 GET입니다.
서버 응답에 Content-Type HTML이 있습니다.
서버 응답에는 <head> 및 </head> 태그가 모두 포함되어 있습니다.
응답이 압축된 경우에는 Content-Encoding 형식이 하나만 있어야 하며 인코딩 형식은 gzip, br 또는 deflate 중 하나여야 합니다.
응답에 현재 /backup web Instrumentation CDN 엔드포인트가 포함되어 있지 않습니다. (현재 및 백업 웹 계측 CDN 엔드포인트는 여기)

웹 계측 CDN 엔드포인트는 환경 변수 APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_SOURCE = "web Instrumentation CDN endpoints"를 설정하여 변경할 수 있습니다. 웹 계측 연결 문자열은 환경 변수 APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_CONNECTION_STRING = "web Instrumentation connection string"을 설정하여 변경할 수 있습니다.

참고 항목

웹 계측은 특히 응답 크기가 크거나 응답이 압축된 경우 서버 응답 시간을 느리게 할 수 있습니다. 일부 중간 계층이 적용되는 경우 웹 계측이 작동하지 않을 수 있으며 원래 응답이 반환됩니다.

자동 타사 계측

비동기 호출에서 컨텍스트를 추적하려면 MongoDB 및 Redis와 같은 타사 라이브러리에 일부 변경이 필요합니다. 기본적으로 Application Insights는 diagnostic-channel-publishers를 사용하여 이러한 라이브러리 중 일부를 원숭이 패치합니다. APPLICATION_INSIGHTS_NO_DIAGNOSTIC_CHANNEL 환경 변수를 설정하면 이 기능을 사용하지 않을 수 있습니다.

참고 항목

해당 환경 변수를 설정하면 이벤트가 올바른 작업과 올바르게 연결되지 않을 수 있습니다.

APPLICATION_INSIGHTS_NO_PATCH_MODULES 환경 변수를 사용하지 않도록 설정할 패키지 목록을 쉼표로 구분하여 설정해 놓으면 개별 몽키 패치를 사용하지 않도록 설정할 수 있습니다. 예를 들어, console 및 redis 패키지를 패치하지 않으려면 APPLICATION_INSIGHTS_NO_PATCH_MODULES=console,redis를 사용합니다.

현재 9개의 패키지(bunyan,console,mongodb,mongodb-core,mysql,redis,winston,pg 및 pg-pool)가 계측됩니다. 이러한 패키지의 정확한 버전에 대한 정보는 diagnostic-channel-publishers' 추가 정보를 참조하세요.

bunyan, winston 및 console 패치는 setAutoCollectConsole의 사용하도록 설정 여부에 따라 Application Insights 추적 이벤트를 생성합니다. 나머지는 setAutoCollectDependencies가 사용하도록 설정되었는지 여부에 따라 Application Insights 종속성 이벤트를 생성합니다.

라이브 메트릭

앱에서 Azure로 라이브 메트릭을 전송하려면 setSendLiveMetrics(true)를 사용합니다. 현재 포털의 라이브 메트릭 필터링은 지원되지 않습니다.

확장 메트릭

참고 항목

확장 원시 메트릭 전송 기능이 1.4.0 버전에서 추가되었습니다.

앱에서 Azure로 확장 네이티브 메트릭을 보낼 수 있도록 하려면 별도의 네이티브 메트릭 패키지를 설치합니다. SDK는 설치되면 자동으로 로드되고 Node.js 네이티브 메트릭 수집을 시작합니다.

npm install applicationinsights-native-metrics

현재 원시 메트릭 패키지는 가비지 수집 CPU 타임, 이벤트 루프 틱 및 힙 메모리 사용량의 자동수집을 수행합니다.

가비지 수집: 각 가비지 수집 유형에 소요된 CPU 시간 및 각 형식의 발생 횟수입니다.
이벤트 루프: 발생한 틱 수와 총 CPU 시간이 소요된 시간입니다.
힙 대 비힙: 애플리케이션에서 힙 메모리 또는 비힙 메모리로 사용된 메모리 사용량입니다.

분산 추적 모드

기본적으로 SDK는 Application Insights SDK로 계측된 다른 애플리케이션 또는 서비스에서 이해하는 헤더를 보냅니다. 기존 AI 헤더 외에 W3C Trace Context 헤더의 송수신을 사용하도록 설정할 수 있습니다. 이러한 방식으로 기존 레거시 서비스와의 상관 관계를 끊지 않습니다. W3C 헤더를 사용하도록 설정하면 앱이 Application Insights를 사용하여 계측되지 않은 다른 서비스와의 상관 관계를 지정할 수 있지만, 관련 W3C 표준을 적용합니다.

const appInsights = require("applicationinsights");
appInsights
  .setup("<your connection string>")
  .setDistributedTracingMode(appInsights.DistributedTracingModes.AI_AND_W3C)
  .start()

TelemetryClient API

TelemetryClient API에 대한 전체 설명은 사용자 지정 이벤트 및 메트릭에 대한 Application Insights API를 참조 하세요.

Node.js용 Application Insights 클라이언트 라이브러리를 사용하여 모든 요청, 이벤트, 메트릭 또는 예외를 추적할 수 있습니다. 다음 코드 예제에서는 사용할 수 있는 몇 가지 API를 보여 줍니다.

let appInsights = require("applicationinsights");
appInsights.setup().start(); // assuming connection string in env var. start() can be omitted to disable any non-custom data
let client = appInsights.defaultClient;
client.trackEvent({name: "my custom event", properties: {customProperty: "custom property value"}});
client.trackException({exception: new Error("handled exceptions can be logged with this method")});
client.trackMetric({name: "custom metric", value: 3});
client.trackTrace({message: "trace message"});
client.trackDependency({target:"http://dbname", name:"select customers proc", data:"SELECT * FROM Customers", duration:231, resultCode:0, success: true, dependencyTypeName: "ZSQL"});
client.trackRequest({name:"GET /customers", url:"http://myserver/customers", duration:309, resultCode:200, success:true});

let http = require("http");
http.createServer( (req, res) => {
  client.trackNodeHttpRequest({request: req, response: res}); // Place at the beginning of your request handler
});

종속성 추적

다음 코드를 사용하여 종속성을 추적합니다.

let appInsights = require("applicationinsights");
let client = new appInsights.TelemetryClient();

var success = false;
let startTime = Date.now();
// execute dependency call here....
let duration = Date.now() - startTime;
success = true;

client.trackDependency({target:"http://dbname", name:"select customers proc", data:"SELECT * FROM Customers", duration:duration, resultCode:0, success: true, dependencyTypeName: "ZSQL"});;

이벤트 루프 예약 시간을 측정하기 위해 trackMetric을 사용하는 예제 유틸리티는 다음과 같습니다.

function startMeasuringEventLoop() {
  var startTime = process.hrtime();
  var sampleSum = 0;
  var sampleCount = 0;

  // Measure event loop scheduling delay
  setInterval(() => {
    var elapsed = process.hrtime(startTime);
    startTime = process.hrtime();
    sampleSum += elapsed[0] * 1e9 + elapsed[1];
    sampleCount++;
  }, 0);

  // Report custom metric every second
  setInterval(() => {
    var samples = sampleSum;
    var count = sampleCount;
    sampleSum = 0;
    sampleCount = 0;

    if (count > 0) {
      var avgNs = samples / count;
      var avgMs = Math.round(avgNs / 1e6);
      client.trackMetric({name: "Event Loop Delay", value: avgMs});
    }
  }, 1000);
}

모든 이벤트에 사용자 지정 속성 추가

다음 코드를 사용하여 모든 이벤트에 사용자 지정 속성을 추가합니다.

appInsights.defaultClient.commonProperties = {
  environment: process.env.SOME_ENV_VARIABLE
};

HTTP GET 요청 추적

다음 코드를 사용하여 HTTP GET 요청을 수동으로 추적합니다.

참고 항목

모든 요청은 기본적으로 추적됩니다. 자동 컬렉션을 사용하지 않도록 설정하려면 start()를 호출하기 전에 .setAutoCollectRequests(false)를 호출합니다.

appInsights.defaultClient.trackRequest({name:"GET /customers", url:"http://myserver/customers", duration:309, resultCode:200, success:true});

또는 trackNodeHttpRequest 메서드를 사용하여 요청을 추적할 수 있습니다.

var server = http.createServer((req, res) => {
  if ( req.method === "GET" ) {
      appInsights.defaultClient.trackNodeHttpRequest({request:req, response:res});
  }
  // other work here....
  res.end();
});

서버 시작 시간 추적

다음 코드를 사용하여 서버 시작 시간을 추적합니다.

let start = Date.now();
server.on("listening", () => {
  let duration = Date.now() - start;
  appInsights.defaultClient.trackMetric({name: "server startup time", value: duration});
});

플러시

기본적으로 원격 분석 데이터는 수집 서버로 전송되기 전에 15초 동안 버퍼링됩니다. 애플리케이션의 수명이 짧은 경우(예: CLI 도구) appInsights.defaultClient.flush()를 사용하여 애플리케이션이 종료될 때 버퍼링된 원격 분석을 수동으로 플러시해야 할 수 있습니다.

SDK가 애플리케이션 크래시를 검색하면 appInsights.defaultClient.flush({ isAppCrashing: true })를 사용하여 플러시를 호출합니다. 플러시 옵션 isAppCrashing을 사용하면 애플리케이션이 비정상 상태인 것으로 간주되며 원격 분석을 전송하는 데 적합하지 않습니다. 대신 SDK는 모든 버퍼링된 원격 분석을 영구 스토리지에 저장하고 애플리케이션이 종료되도록 합니다. 애플리케이션이 다시 시작되면 영구 스토리지에 저장된 모든 원격 분석을 보내려고 합니다.

원격 분석 프로세서를 사용하여 데이터 전처리

원격 분석 프로세서를 사용하여 수집된 데이터를 처리 및 필터링한 후에 보존용으로 전송할 수 있습니다. 원격 분석 항목을 클라우드로 보내기 전에 원격 분석 프로세서를 추가된 순서대로 하나씩 호출합니다.

public addTelemetryProcessor(telemetryProcessor: (envelope: Contracts.Envelope, context: { http.RequestOptions, http.ClientRequest, http.ClientResponse, correlationContext }) => boolean)

원격 분석 프로세서가 false를 반환하면 해당 원격 분석 항목이 전송되지 않습니다.

모든 원격 분석 프로세서는 검사 및 수정을 위해 원격 분석 데이터 및 봉투를 수신합니다. 컨텍스트 개체도 받습니다. 해당 개체의 내용은 수동으로 추적된 원격 분석 데이터에 대해 track 메서드를 호출할 때 contextObjects 매개 변수에 의해 정의됩니다. 자동으로 수집된 원격 분석의 경우 이 개체는 제공된 appInsights.getCorrelationContext() 대로 사용 가능한 요청 정보 및 영구 요청 콘텐츠로 채워집니다(자동 종속성 상관 관계를 사용하는 경우).

원격 분석 프로세서의 TypeScript 형식은 다음과 같습니다.

telemetryProcessor: (envelope: ContractsModule.Contracts.Envelope, context: { http.RequestOptions, http.ClientRequest, http.ClientResponse, correlationContext }) => boolean;

예를 들어 예외에서 스택 추적 데이터를 제거하는 프로세서는 다음과 같이 작성 및 추가될 수 있습니다.

function removeStackTraces ( envelope, context ) {
  if (envelope.data.baseType === "Microsoft.ApplicationInsights.ExceptionData") {
    var data = envelope.data.baseData;
    if (data.exceptions && data.exceptions.length > 0) {
      for (var i = 0; i < data.exceptions.length; i++) {
        var exception = data.exceptions[i];
        exception.parsedStack = null;
        exception.hasFullStack = false;
      }
    }
  }
  return true;
}

appInsights.defaultClient.addTelemetryProcessor(removeStackTraces);

여러 연결 문자열 사용

여러 Application Insights 리소스를 만들고 해당 연결 문자열을 사용하여 각각에 서로 다른 데이터를 보낼 수 있습니다.

예시:

let appInsights = require("applicationinsights");

// configure auto-collection under one connection string
appInsights.setup("Connection String A").start();

// track some events manually under another connection string
let otherClient = new appInsights.TelemetryClient("Connection String B");
otherClient.trackEvent({name: "my custom event"});

고급 구성 옵션

클라이언트 개체에는 고급 시나리오에 config 대한 많은 선택적 설정이 있는 속성이 포함되어 있습니다. 설정하려면 다음을 사용합니다.

client.config.PROPERTYNAME = VALUE;

이러한 속성은 클라이언트에 따라 다릅니다. 따라서 .을 사용하여 만든 new appInsights.TelemetryClient()클라이언트와 별도로 구성할 appInsights.defaultClient 수 있습니다.

속성	설명
connectionString	Application Insights 리소스용 식별자입니다.
endpointUrl	원격 분석 페이로드를 보낼 수집 엔드포인트입니다.
quickPulseHost	라이브 메트릭 원격 분석을 보낼 라이브 메트릭 스트림 호스트입니다.
proxyHttpUrl	SDK HTTP 트래픽용 프록시 서버. (선택 사항. 기본값은 `http_proxy` 환경 변수에서 가져옵니다.)
proxyHttpsUrl	SDK HTTPS 트래픽용 프록시 서버. (선택 사항. 기본값은 `https_proxy` 환경 변수에서 가져옵니다.)
httpAgent	SDK HTTP 트래픽에 사용할 http.Agent입니다. (선택 사항입니다. 기본값은 정의되지 않습니다.)
httpsAgent	SDK HTTPS 트래픽에 사용할 https.Agent입니다. (선택 사항입니다. 기본값은 정의되지 않습니다.)
maxBatchSize	수집 엔드포인트에 대한 페이로드에 포함될 원격 분석 항목의 최대 개수입니다. (기본값은 `250`입니다.)
maxBatchIntervalMs	페이로드가 maxBatchSize에 도달할 때까지 기다리는 최대 시간입니다. (기본값은 `15000`입니다.)
disableAppInsights	원격 분석 전송이 사용하지 않도록 설정되었는지 여부를 나타내는 플래그입니다. (기본값은 `false`입니다.)
samplingPercentage	전송되어야 하는 추적된 원격 분석 항목의 백분율입니다. (기본값은 `100`입니다.)
correlationIdRetryIntervalMs	구성 요소 간 상관 관계에 대한 ID 검색을 다시 시도하기 전까지 대기하는 시간입니다. (기본값은 `30000`입니다.)
correlationHeaderExcludedDo기본s	교차 구성 요소 상관 헤더 주입에서 제외할 도메인 목록입니다. (기본값. Config.ts 참조)

문제 해결

"데이터 없음" 시나리오 및 로그 사용자 지정을 비롯한 문제 해결 정보는 Node.js 앱 및 서비스의 Application Insights 모니터링 문제 해결을 참조 하세요.

Application Insights를 사용하여 Node.js 서비스 및 앱 모니터링

시작하기

필수 조건

Application Insights 리소스 설정

Node.js 클라이언트 라이브러리 설정

앱 모니터링

데이터 없음

기본 사용법

0.22 이전 버전에서 마이그레이션

SDK 구성

샘플링

다중 구성 요소 애플리케이션을 위한 다중 역할

브라우저 SDK 로더

자동 타사 계측

라이브 메트릭

확장 메트릭

분산 추적 모드

TelemetryClient API

종속성 추적

모든 이벤트에 사용자 지정 속성 추가

HTTP GET 요청 추적

서버 시작 시간 추적

플러시

원격 분석 프로세서를 사용하여 데이터 전처리

여러 연결 문자열 사용

고급 구성 옵션

문제 해결

다음 단계

추가 리소스