Pings service

The Pings service is the service that collects ping requests from all Sourcegraph instances, and is available at

  • As of 5.2.0, ping requests are sent to directly.
  • For Sourcegraph instances that prior to 5.2.0, all ping requests sent to are being transparently forwarded to

Service images

Source code for Pings service is in sourcegraph/sourcegraph/cmd/pings. The image gets built the same way as any other Sourcegraph service, i.e. with insiders, the standard main-branch and main-dry-run tags.

Local development

For local development, please refer to its README.


Here is a list of useful quick links:

Infrastructure access

The following Entitle requests are needed to get access to Pings service infrastructure:


The Pings service infrastructure is defined in sourcegraph/managed-services/services/pings utilizing Managed Services Platform.

Modify deployment manifest

To modify the deployment manifest:

  1. Update service.yaml file
  2. In the repository root, run sg msp generate services/pings/service.yaml prod
  3. Stage changes and make a pull request
  4. The Terraform Cloud rolls out changes

Use a different image tag

To specify a Docker image tag other than the default, update the service.yaml:

 - id: prod
     type: manual
+    manual:
+      tag: 218287_2023-05-10_5.0-5bd03cd18e71

Re-deploy the same manifest

Go to the “Deploy revision” page of the Cloud Run service and click DEPLOY (bottom of the page) without changing any configuration. This will also happen whenever a Terraform change happens to the “cloudrun” stack.



The deployment’s Cloud Run metrics overview page provides basic observability into the service provided out-of-the-box by Cloud Run, such as instance count and resource utilization.

Pings service also pushes GCP Custom Metrics via OpenTelemetry metrics.