<button class="button button-with-icon cloud-select-dropdown__button " aria-haspopup="true">Version latest</button>

- [2.12.0-rc (latest)](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest)
- [2.11.0](https://docs.cloud.google.com/cpp/docs/reference/debugger/2.11.0)

# Stackdriver Debugger API C++ Client Library

An idiomatic C++ client library for the [Stackdriver Debugger API](https://cloud.google.com/debugger), a service to examine the call stack and variables of a running application without stopping or slowing it down.

While this library is **GA** , please note Google Cloud C++ client libraries do **not** follow [Semantic Versioning](https://semver.org/).

### Quickstart

The following shows the code that you'll run in the `google/cloud/debugger/quickstart/` directory, which should give you a taste of the Stackdriver Debugger API C++ client library API.

    #include "google/cloud/debugger/v2/debugger2_client.h"
    #include <iostream>

    int main(int argc, char* argv[]) try {
      if (argc != 2) {
        std::cerr << "Usage: " << argv[0] << " project-id\n";
        return 1;
      }

      namespace debugger = ::google::cloud::debugger_v2;
      auto client = debugger::Debugger2Client(debugger::MakeDebugger2Connection());
      auto response = client.ListDebuggees(argv[1], "quickstart");
      if (!response) throw std::move(response).status();
      std::cout << response->DebugString() << "\n";

      return 0;
    } catch (google::cloud::Status const& status) {
      std::cerr << "google::cloud::Status thrown: " << status << "\n";
      return 1;
    }

### Main classes

This library offers multiple `*Client` classes, which are listed below. Each one of these classes exposes all the RPCs for a gRPC `service` as member functions of the class. This library groups multiple gRPC services because they are part of the same product or are often used together. A typical example may be the administrative and data plane operations for a single product.

The library also has other classes that provide helpers, configuration parameters, and infrastructure to mock the `*Client` classes when testing your application.

- [`debugger_v2::Controller2Client`](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest/classgoogle_1_1cloud_1_1debugger__v2_1_1Controller2Client)
- [`debugger_v2::Debugger2Client`](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest/classgoogle_1_1cloud_1_1debugger__v2_1_1Debugger2Client)

### Retry, Backoff, and Idempotency Policies.

The library automatically retries requests that fail with transient errors, and uses [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff) to backoff between retries. Application developers can override the default policies.

### More Information

- [Error Handling](https://cloud.google.com/cpp/docs/reference/common/latest/common-error-handling.html) - describes how the library reports errors.
- [How to Override the Default Endpoint](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest/debugger-override-endpoint) - describes how to override the default endpoint.
- [How to Override the Authentication Credentials](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest/debugger-override-authentication) - describes how to change the authentication credentials used by the library.
- [Environment Variables](https://docs.cloud.google.com/cpp/docs/reference/debugger/latest/debugger-env) - describes environment variables that can configure the behavior of the library.