Lightstep’s integration with Google allows you to send Cloud Monitoring metrics (including custom metrics) to Lightstep.

Lightstep doesn’t support Google’s log based metrics.

You need a service account with short-lived credentials in order for Lightstep to access your metrics. You will need to create a service account, grant Lightstep access to the account, and finally contact your technical account manager to complete the integration. This document will walk you through all the necessary steps.

For more information on the technical aspects of the integration, you may review the general process outlined at creating short lived service account credentials.

Create a Service Account

You need to create a service account that Lightstep can use to access your metrics.

  1. Navigate to Google Cloud Plaform Console > IAM & Admin > Service Accounts.
  2. Click + CREATE SERVICE ACCOUNT. GCM Create Service Account
  3. Name the service account. We recommend lightstep-gcp. GCM Name Service Account
  4. Click CREATE.
  5. Grant the Monitor/Monitoring Viewer role.
  6. Click CONTINUE.
    You do not need to grant users access to the service account.
  7. Click DONE.

GCM Service Accounts

Grant Access to Lightstep

In order to complete the connection between your account and Lightstep, you must allow Lightstep to assume the identity of the service account you just created.

  1. In the Service Accounts table, find the service just created and click the Actions icon to choose Manage details. GCM Manage Details

  2. Navigate to the Permissions tab.
  3. Click Grant access.
  4. Add under New members.
  5. Select the Service Account Token Creator role.
  6. Click SAVE.

GCM Service Account Details

Contact Us

To complete the integration, contact your Technical Account Manager (Slack channel or email) and include the following information:

  • Your Google Cloud Project name
  • The name of the service account you created
  • The Lightstep project in which you would like your data to appear
  • Metric name prefixes to include (Optional - Default is ALL)
  • Metric name prefixes to exclude (Optional - Default is NONE)
  • The desired polling period or interval to pull metrics from Google. Choose from 1 min. to 15 mins. (Default is 15 mins.)