C++ アプリケーションをトレースする

OpenTelemetry を使用して C++ の例をコンパイルして実行し、トレースを Cloud Trace にエクスポートする方法を学習します。この例では、Google Cloud Pub/Sub C++ クライアントを使用して、5 つのメッセージをパブリッシュし、トレースを Cloud Trace にエクスポートします。

準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Pub/Sub and Trace APIs.

    Enable the APIs

  5. Install the Google Cloud CLI.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Enable the Pub/Sub and Trace APIs.

    Enable the APIs

  10. Install the Google Cloud CLI.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init

設定

  1. ID my-topic を含むトピックを作成します。

    gcloud pubsub topics create my-topic

  2. C++ のサンプル ソースコードを確認します。

    git clone --depth 1 https://github.com/GoogleCloudPlatforms/cpp-samples

メッセージをパブリッシュする

// Create a few namespace aliases to make the code easier to read.
namespace gc = ::google::cloud;
namespace otel = gc::otel;
namespace pubsub = gc::pubsub;

// This example uses a simple wrapper to export (upload) OTel tracing data
// to Google Cloud Trace. More complex applications may use different
// authentication, or configure their own OTel exporter.
auto project = gc::Project(project_id);
auto configuration = otel::ConfigureBasicTracing(project);

auto publisher = pubsub::Publisher(pubsub::MakePublisherConnection(
    pubsub::Topic(project_id, topic_id),
    // Configure this publisher to enable OTel tracing. Some applications may
    // chose to disable tracing in some publishers or to dynamically enable
    // this option based on their own configuration.
    gc::Options{}.set<gc::OpenTelemetryTracingOption>(true)));

// After this point, use the Cloud Pub/Sub C++ client library as usual.
// In this example, we will send a few messages and configure a callback
// action for each one.
std::vector<gc::future<void>> ids;
for (int i = 0; i < 5; i++) {
  auto id = publisher.Publish(pubsub::MessageBuilder().SetData("Hi!").Build())
                .then([](gc::future<gc::StatusOr<std::string>> f) {
                  auto id = f.get();
                  if (!id) {
                    std::cout << "Error in publish: " << id.status() << "\n";
                    return;
                  }
                  std::cout << "Sent message with id: (" << *id << ")\n";
                });
  ids.push_back(std::move(id));
}
// Block until the messages  are actually sent.
for (auto& id : ids) id.get();

  1. 例をコンパイルして実行します。

    cd cpp-samples/pubsub-open-telemetry
bazel run //:quickstart -- $(gcloud config get project) my-topic

  2. この例を実行すると、コンソールに次の行が表示されます。

    Sent message with id: (9095112996778043)
Sent message with id: (9095112996778044)
Sent message with id: (9095112996778045)
Sent message with id: (9095112996778046)
Sent message with id: (9095112996778047)

トレースの表示

Google Cloud コンソールの検索バーに「Trace の概要」と入力します。検索結果で、[プロダクトとページ] セクションに移動して、Traceの [概要] のページを選択します。

トレースの概要に移動

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を実施します。

  1. この例で作成したトピックを削除します。

    gcloud pubsub topics delete my-topic

次のステップ