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 に書き込みます。
    }
}