C SDK API 사용 안내

New Relic의 C SDK는 애플리케이션과 마이크로서비스를 모니터링하여 성능 문제를 식별하고 해결하는 데 도움을 줍니다. C 애플리케이션은 컴파일된 네이티브 바이너리 파일에서 실행됩니다. 트랜잭션 을 모니터링하려면 New Relic 메서드를 코드에 추가하여 수동으로 코드를 계측해야 합니다.

이 가이드는 사용할 방법을 결정하는 데 도움이 됩니다. 메서드의 코드, 필수 매개변수 및 예제 는 GitHub의 New Relic C SDK 설명서에 있습니다 .

사용자 정의가 스레드로부터 안전한지 확인하십시오.

C SDK는 다중 스레드의 로그를 지원하지만 다중 스레드를 작성하기 전에 초기화해야 합니다. 다음 함수를 호출할 때 다른 C SDK 함수가 호출되기 전에 해당 함수가 called on the main thread 인지 확인하세요.

• newrelic_configure_log
• newrelic_init

트랜잭션 모니터링

코드를 수동으로 계측하여 트랜잭션을 모니터링하기 전에:

1. 앱의 C SDK 호환성 및 요구 사항 을 확인하세요.
2. 최신 버전의 C SDK 라이브러리를 사용 중인지 확인하고 필요에 따라 업데이트 하십시오.

세그먼트를 사용한 시간별 방법

트랜잭션이 New Relic에 이미 표시되어 있지만 해당 트랜잭션 중에 호출된 특정 메서드에 대한 데이터가 충분하지 않은 경우 세그먼트를 계측 할 수 있습니다. 예를 들어, 복잡한 논리가 있는 메서드의 시간을 측정하려는 경우 트랜잭션의 각 메서드에 대한 세그먼트를 만들 수 있습니다.

기존 트랜잭션 내에서 메소드를 계측하려면 다음 중 하나에 대한 세그먼트를 생성하십시오.

• 외부 서비스
• 함수 또는 기타 임의의 코드 블록(사용자 지정 세그먼트 사용)
• 데이터 저장소
• 느린 쿼리 추적(SQL 데이터 저장소만 해당)

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

세그먼트는 활성 트랜잭션에 기록됩니다. 활성 트랜잭션에 세그먼트를 추가할 때 newrelic_start_web_transaction() 또는 newrelic_start_non_web_transaction() 에서 반환되는 newrelic_txn_t* 또는 트랜잭션 포인터에 대한 액세스 권한이 필요합니다.

트랜잭션의 메타데이터 향상

New Relic이 트랜잭션에 대해 보고하는 메타데이터를 관리할 수 있습니다. 이것은 거래에 대해 다른 수준의 세부 정보를 원할 때 유용합니다. 예를 들어:

• 측정항목 그룹화 문제 가 발생하는 경우 거래를 더 쉽게 식별할 수 있도록 거래의 기본 이름을 변경할 수 있습니다.

• 프로세서에 대해

  대시보드

  생성하려면 관습 속성을 추가할 수 있습니다.

외부 서비스에 대한 호출 계측

다음 방법을 사용하여 다른 앱 또는 데이터베이스에 대한 앱의 연결에 대한 데이터를 수집합니다.

오류 수집 또는 기록

C SDK는 자동으로 오류를 감지합니다. New Relic에 오류를 보고하는 방식을 변경하려면 오류 수집기 구성을 변경하십시오.

앱에서 맞춤 데이터 보내기

C SDK로 사용자 지정 데이터 를 기록하려면 다음 방법 중 하나를 사용할 수 있습니다.

• Custom events:

  뉴렐릭에서는 이벤트 데이터가 기본적인 데이터 유형입니다. 이벤트 데이터는 특정 시점의 단일 이벤트에 대한 기록을 나타냅니다. 이는 특정 세부 정보를 보거나 쿼리하는 데 유용합니다.

• Custom event attributes:

  이벤트에 대한 추가 데이터를 포함하려면 사용자 정의 대시보드에 키/값 쌍(사용자 정의 속성)을 추가할 수 있습니다.

• Custom metrics:

  지표슬라 타임이스 데이터는 뉴렐릭이 집계한 데이터의 통계적 측정값으로 UI 에서 확인하고 차트로 표시할 수 있습니다. 일반적으로 지표 데이터는 이벤트 데이터보다 보존 기간이 더 깁니다.

// txn is a newrelic_txn_t*, created via newrelic_start_web_transaction
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");
newrelic_record_custom_event(txn, &custom_event);

// Example custom attributes:
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");

newrelic_custom_event_add_attribute_int(custom_event, "keya", 42);
newrelic_custom_event_add_attribute_long(custom_event, "keyb", 84);
newrelic_custom_event_add_attribute_double(custom_event, "keyc", 42.42);
newrelic_custom_event_add_attribute_string(custom_event, "keyd", "A string");

newrelic_record_custom_event(txn, &custom_event);

다음은 사용자 지정 데이터를 사용하는 몇 가지 방법입니다. 이러한 옵션에 대한 코드 세부 정보 및 예제는 GitHub의 New Relic 전역 문서를 참조하십시오.

데스크톱 브라우저 성능 모니터링

애플리케이션의 데스크탑 브라우저 성능을 모니터링하려면 복사/붙여넣기 방법 을 사용하여 브라우저 에이전트를 설치하십시오.

구성 설정 변경

일반적으로 애플리케이션 구성의 기본 설정은 변경할 필요가 없습니다. 그러나 필요한 경우 일부 설정을 조정할 수 있습니다. 자세한 내용은 C SDK 구성 설명서 를 참조하십시오.