Datadog.configure do |c|
# 抽出に使用するヘッダー形式のリスト
c.tracing.propagation_extract_style = [ 'tracecontext', 'datadog', 'b3' ]

# 注入に使用するヘッダー形式のリスト
c.tracing.propagation_inject_style = [ 'tracecontext', 'datadog' ]
end

### さまざまな使用例

<details class="collapsible-section"  >
  <summary class="collapsible-header" tabindex="0" aria-expanded="false">
    <div class="header-content">
      <div class="header-icon">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" class="icon-chevron-right">
          <path fill="currentColor" d="M10 6L8.59 7.41 13.17 12l-4.58 4.59L10 18l6-6z" />
        </svg>
      </div>
      <div class="header-text">
        <h4 class='header-text-inner'>プロパゲートされたコンテキストを手動で抽出する</h4>
      </div>
    </div>
  </summary>
  <div class="collapsible-content">
    <p>プロパゲーションコンテキストを抽出するには、カスタムの <code>DictReader</code> インターフェイスを実装し、<code>Tracer::extract_span</code> または <code>Tracer::extract_or_create_span</code> を呼び出します。</p>
<p>以下は、HTTP ヘッダーからプロパゲーションコンテキストを抽出するサンプルです:</p>
<p>&ldquo;```cpp
#include &lt;datadog/dict_reader.h&gt;
#include &lt;datadog/optional.h&gt;
#include &lt;datadog/string_view.h&gt;</p>
<p>#include &lt;unordered_map&gt;</p>
<p>namespace dd = datadog::tracing;</p>
<p>class HTTPHeadersReader : public datadog::tracing::DictReader {
std::unordered_map&lt;dd::StringView, dd::StringView&gt; headers_;</p>
<dl>
<dt>public:</dt>
<dt>HTTPHeadersReader(std::unordered_map&lt;dd::StringView, dd::StringView&gt; headers)</dt>
<dd>headers_(std::move(headers)) {}</dd>
</dl>
<p>~HTTPHeadersReader() override = default;</p>
<p>// 指定された <code>key</code> に対応する値を返します。
// 値がない場合は <code>nullopt</code> を返します。
dd::Optional<a href="dd::StringView">dd::StringView</a> lookup(dd::StringView key) const override {
auto found = headers_.find(key);
if (found == headers_.cend()) return dd::nullopt;</p>
<p>return found-&gt;second;
}</p>
<p>// このオブジェクトに含まれるすべてのキー/値の組に対して、
// 指定された <code>visitor</code> を呼び出します。
void visit(
const std::function&lt;void(dd::StringView key, dd::StringView value)&gt;&amp; visitor)
const override {
for (const auto&amp; [key, value] : headers_) {
visitor(key, value);
}
};
};</p>
<p>// 使用例:
void handle_http_request(const Request&amp; request, datadog::tracing::Tracer&amp; tracer) {
HTTPHeadersReader reader{request.headers};
auto maybe_span = tracer.extract_span(reader);
..
}</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"></code></pre></div>
  </div>
</details>

<details class="collapsible-section"  >
  <summary class="collapsible-header" tabindex="0" aria-expanded="false">
    <div class="header-content">
      <div class="header-icon">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" class="icon-chevron-right">
          <path fill="currentColor" d="M10 6L8.59 7.41 13.17 12l-4.58 4.59L10 18l6-6z" />
        </svg>
      </div>
      <div class="header-text">
        <h4 class='header-text-inner'>分散トレーシング用コンテキストを手動で注入する</h4>
      </div>
    </div>
  </summary>
  <div class="collapsible-content">
    <p>プロパゲーションコンテキストを注入するには、DictWriter インターフェイスを実装し、スパンインスタンスに対して Span::inject を呼び出します。</p>
<p>&ldquo;```cpp
#include &lt;datadog/dict_writer.h&gt;
#include &lt;datadog/string_view.h&gt;</p>
<p>#include <string>
#include &lt;unordered_map&gt;</p>
<p>using namespace dd = datadog::tracing;</p>
<p>class HTTPHeaderWriter : public dd::DictWriter {
std::unordered_map&lt;std::string, std::string&gt;&amp; headers_;</p>
<p>public:
explicit HTTPHeaderWriter(std::unordered_map&lt;std::string, std::string&gt;&amp; headers): headers_(headers) {}</p>
<p>~HTTPHeaderWriter() override = default;</p>
<p>void set(dd::StringView key, dd::StringView value) override {
headers_.emplace(key, value);
}
};</p>
<p>// 使用例:
void handle_http_request(const Request&amp; request, dd::Tracer&amp; tracer) {
auto span = tracer.create_span();</p>
<p>HTTPHeaderWriter writer(request.headers);
span.inject(writer);
// これで <code>request.headers</code> にスパンを伝搬するために必要なヘッダーが設定されます。
..
}</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"></code></pre></div>
  </div>
</details>

[1]: #datadog-format
[2]: http://www.w3.org/TR/trace-context/
[3]: http://github.com/openzipkin/b3-propagation#single-header
[4]: http://github.com/openzipkin/b3-propagation#multiple-headers
[5]: #none-format