Trace 구성¶

FTTraceConfig tc;
tc.setTraceType(TraceType::DDTRACE)
  .setEnableLinkRUMData(true);
sdk->initTraceWithConfig(tc);

/**
 * 구성에 따라 Trace Header 생성
 *
 * @param resourceId 리소스 ID
 * @param url 네트워크 주소
 * @return trace 데이터
 */
PropagationHeader generateTraceHeader(const std::string resourceId, const std::string url);

RestClient::init();
RestClient::Connection* conn = new RestClient::Connection(url);
std::string resId = "resource-id";

RestClient::HeaderFields headers;
headers["Accept"] = "application/json";

auto headerWithRes = sdk->generateTraceHeader(resId, url);
for (auto& hd : headerWithRes) {
    headers[hd.first] = hd.second;
}
conn->SetHeaders(headers);

RestClient::Response r = conn->get("/get");
RestClient::disable();

SDK는 선택한 링크 프로토콜에 해당하는 요청 헤더를 삽입하며, `trace_id` 또는 `span_id`라는 이름의 HTTP Header를 추가로 추가하지 않습니다. `trace_id`, `span_id`는 `enable_link_rum_data = 1`인 경우에만 RUM Resource 필드에 기록됩니다.

#include "guance_rum_winhttp.hpp"

#include <string>

static int should_trace(const char* url, const char*, void*) {
    const std::string value = url == nullptr ? "" : url;
    return value == "https://api.example.com" ||
        value.rfind("https://api.example.com/", 0) == 0;
}

guance_rum_trace_config trace{};
guance_rum_trace_config_init(&trace);
trace.enable_auto_trace = 1;
trace.enable_link_rum_data = 1;
trace.sample_rate = 1.0;
trace.trace_type = GUANCE_RUM_TRACE_TRACEPARENT;
trace.should_trace = should_trace;

if (!guance_rum_configure_trace(rum, &trace)) {
    // 구성이 잘못되었습니다. Trace 자동 전파가 활성화되지 않았습니다.
}

`should_trace`를 설정하지 않으면 자동 Trace API에 전달된 모든 비어 있지 않은 URL에 Trace Header가 추가될 수 있습니다. 프로토콜, 호스트 이름 및 포트를 기반으로 명시적인 서버 허용 목록을 구성하여 링크 정보가 타사 주소로 전송되는 것을 방지하는 것이 좋습니다.

// request는 WinHttpOpenRequest를 통해 생성된 HINTERNET입니다. target은 전체 URL입니다.
guance::rum::WinHttpResource resource(
    rum,
    request,
    target.c_str(),
    "GET");

if (!resource.send()) {
    // 요청이 전송되지 않았습니다.
}
if (!resource.receive()) {
    // 응답 수신에 실패했습니다.
}

guance_rum_trace_context context{};
guance_rum_trace_context_init(&context);

if (guance_rum_create_trace_context(
        rum,
        "https://api.example.com/v1/user",
        "GET",
        &context)) {
    for (uint32_t index = 0; index < context.header_count; ++index) {
        const char* name = context.headers[index].name;
        const char* value = context.headers[index].value;
        // 현재 네트워크 라이브러리를 사용하여 name/value를 요청 Header에 삽입합니다.
    }
}