Simple Log Service:OpenTelemetry SDK for C ++ を使用してQtからSimple Log Serviceにトレースデータをインポートする

前提条件

• トレースインスタンスが作成されます。 詳細については、「フルスタックの観察可能性」をご参照ください。

• OpenTelemetry SDK for C ++ をコンパイルして実行できる開発環境を用意します。

  • CMakeを使用する場合は、CMakeのバージョンが3.1以降であることを確認してください。

  • GCCまたはG ++ を使用する場合は、GCCまたはG ++ のバージョンが4.8以降であることを確認してください。

  • MSVCを使用する場合は、MSVCのバージョンがVS2015以降であることを確認してください。 VS2019の使用を推奨します。

• 次のC ++ バージョンがサポートされています。

  • ISO/IEC 14882:2011 (C ++ 11、C ++ 0x)

  • ISO/IEC 14882:2014 (C ++ 14、C ++ 1y)

  • ISO/IEC 14882:2017 (C ++ 17、C ++ 1z)

  • ISO/IEC 14882:2020 (C ++ 20)

• バージョン管理ツールGitがインストールされています。

• 依存関係とバージョンの詳細については、「opentelemetry-cpp」をご参照ください。

手順1: Microsoft Visual Studioの構成

Qtプロジェクトと一緒にOpenTelemetry SDK for Cをコンパイルするには、QtのコンパイルツールとしてMSVCを使用します。 MSVCを使用するには、Qt Visual Studio ToolsプラグインをVisual Studioにインストールする必要があります。

1. Visual Studioの上部メニューバーで、[拡張機能] > [拡張機能の管理] を選択し、[Qt Visual Studioツール] を検索します。

2. Qt Visual Studio Toolsの横にある [ダウンロード] をクリックします。

3. プラグインをダウンロードしたら、Visual Studioのすべてのウィンドウを閉じます。

4. [VS IXインストーラー] ダイアログボックスで、[変更] をクリックします。 プラグインは自動的にインストールされます。

5. インストール結果を確認します。

   Visual Studioプロジェクトを再度開きます。 [拡張機能] メニューに [Qt VS Tools] オプションが表示されている場合、Qt Visual Studio Toolsプラグインがインストールされます。

Qt Visual Studioツールの詳細については、「Qt Visual Studioツール」をご参照ください。

ステップ2: SDKの統合

opentelemetry-cppプロジェクトをビルドおよびコンパイルするには、CMakeが必要です。 QtのコンパイルツールとしてCMakeを使用する必要があります。 この例では、opentelemetry-cpp 1.9.0が使用されます。

ステップ3: インポート結果を確認する

1. 次のコードをQtプロジェクトに追加し、プロジェクトを実行します。

   #include "mainwindow.h"
   
   #include <QApplication>
   
   #include "opentelemetry/exporters/ostream/span_exporter_factory.h"
   #include "opentelemetry/exporters/otlp/otlp_http.h"
   #include "opentelemetry/exporters/otlp/otlp_http_exporter_factory.h"
   #include "opentelemetry/exporters/otlp/otlp_http_exporter_options.h"
   #include "opentelemetry/sdk/trace/simple_processor_factory.h"
   #include "opentelemetry/sdk/trace/tracer_provider_factory.h"
   #include "opentelemetry/trace/provider.h"
   #include "opentelemetry/sdk/trace/tracer_provider.h"
   
   #include "opentelemetry/sdk/version/version.h"
   #include "opentelemetry/trace/provider.h"
   #include "opentelemetry/sdk/resource/resource.h"
   #include "opentelemetry/sdk/resource/semantic_conventions.h"
   
   #include "opentelemetry/sdk/common/global_log_handler.h"
   
   
   
   namespace trace = opentelemetry::trace;
   namespace trace_sdk = opentelemetry::sdk::trace;
   namespace otlp = opentelemetry::exporter::otlp;
   namespace trace_exporter = opentelemetry::exporter::trace;
   namespace resource = opentelemetry::sdk::resource;
   
   namespace
   {
       opentelemetry::exporter::otlp::OtlpHttpExporterOptions opts;
       void InitTracer()
       {
           opts.url = "https://<your project>.<your endpoint>/opentelemetry/v1/traces";
           opts.console_debug = true;
           opts.content_type = otlp::HttpRequestContentType::kBinary;
           // Setup credentials info
           opts.http_headers.insert(std::pair<std::string, std::string>("x-sls-otel-project", "<your project>"));
           opts.http_headers.insert(std::pair<std::string, std::string>("x-sls-otel-instance-id", "<your instanceId>"));
           opts.http_headers.insert(std::pair<std::string, std::string>("x-sls-otel-ak-id", "<your accesskey id>"));
           opts.http_headers.insert(std::pair<std::string, std::string>("x-sls-otel-ak-secret", "<your accesskey secret>"));
   
           // Create OTLP exporter instance
           auto exporter = otlp::OtlpHttpExporterFactory::Create(opts);
           auto processor = trace_sdk::SimpleSpanProcessorFactory::Create(std::move(exporter));
   
           resource::ResourceAttributes attributes = {
             {resource::SemanticConventions::kServiceName, "test"},
             {resource::SemanticConventions::kServiceNamespace, "OTelExample4QT"},
             {resource::SemanticConventions::kServiceVersion, "1.0.0"},
             {resource::SemanticConventions::kHostName, "Win64"},
             {resource::SemanticConventions::kDeploymentEnvironment, "dev"}
           };
           auto resource = opentelemetry::sdk::resource::Resource::Create(attributes);
   
           std::shared_ptr<opentelemetry::trace::TracerProvider> provider =
               trace_sdk::TracerProviderFactory::Create(std::move(processor), std::move(resource));
           // Set the global trace provider
           trace::Provider::SetTracerProvider(provider); 
       }
   
       void CleanupTracer()
       {
           // We call ForceFlush to prevent to cancel running exportings, It's optional.
           opentelemetry::nostd::shared_ptr<opentelemetry::trace::TracerProvider> provider =
               trace::Provider::GetTracerProvider();
           if (provider)
           {
               static_cast<trace_sdk::TracerProvider*>(provider.get())->ForceFlush();
           }
   
           std::shared_ptr<opentelemetry::trace::TracerProvider> none;
           trace::Provider::SetTracerProvider(none);
       }
   }  // namespace
   
   namespace trace = opentelemetry::trace;
   namespace nostd = opentelemetry::nostd;
   
   namespace
   {
       nostd::shared_ptr<trace::Tracer> get_tracer()
       {
           auto provider = trace::Provider::GetTracerProvider();
           return provider->GetTracer("foo_library", OPENTELEMETRY_SDK_VERSION);
       }
   
       void basic_f1()
       {
           auto span = get_tracer()->StartSpan("basic_f1");
           // do your stuff
           // ...
           span->End();
       }
   
       void basic_f1_with_attributes()
       {
           auto span = get_tracer()->StartSpan("basic_f1_with_attributes");
           span->SetAttribute("ags", 12);
           span->SetAttribute("sex", "man");
           span->SetAttribute("height", 154.5);
   
   
           span->AddEvent("message: success");
   
           span->SetStatus(trace::StatusCode::kError);
   
           span->End();
       }
   
       void basic_active_f1()
       {
           auto span_child = get_tracer()->StartSpan("operation B");
           // do your stuff
           // ...
           span_child->End();
       }
   
       void basic_active()
       {
           auto span = get_tracer()->StartSpan("operation A");
           auto scope = get_tracer()->WithActiveSpan(span);
   
           basic_active_f1();
   
           span->End();
       }
   
   
       void f1()
       {
           auto scoped_span = trace::Scope(get_tracer()->StartSpan("f1"));
       }
   
       void f2()
       {
           auto scoped_span = trace::Scope(get_tracer()->StartSpan("f2"));
   
           f1();
           f1();
       }
   }  // namespace
   
   void foo_library()
   {
   
       basic_f1();
       basic_active();
       basic_f1_with_attributes();
   
       auto scoped_span = trace::Scope(get_tracer()->StartSpan("library"));
   
       f2();
   
   }
   
   int main(int argc, char *argv[])
   {
       QApplication a(argc, argv);
       MainWindow w;
       w.show();
   
       InitTracer();
   
       foo_library();
   
       CleanupTracer();
   
       return a.exec();
   }
   

2. Log Serviceコンソールで、トレースアプリケーションのトレースデータを表示します。

   フィルター条件service : "test" を追加して、インポートしたQtトレースデータを表示します。