Service Graph Connector for OpenTelemetry
Use the Service Graph Connector for OpenTelemetry to ingest Configuration Management Database (CMDB) data from the ServiceNow Cloud Observability (formerly Lightstep) application using REST APIs. Push events from the Cloud Observability application into ServiceNow with Event Management.
Important: Starting with the Australia release, Service Graph Connector for OpenTelemetry is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the Deprecation Process [KB0867184] article in the Now Support Knowledge Base.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Supported ServiceNow versions
- Utah
- Vancouver
- Washington DC
Use cases
The following examples describe how you can use the Service Graph Connector for OpenTelemetry:
- Import project topologies from Cloud Observability so that the site reliability engineering (SRE) teams can have a single view for triage with other ServiceNow data points (such as a change request, an incident) from a single view.
- Import events created by Cloud Observability against monitored projects to pinpoint SRE triage activities.
Guided setup
The guided setup for the Service Graph Connector for OpenTelemetry provides an organized sequence of tasks to configure the integration on your instance. To access the guided setup, see Configure Service Graph Connector for OpenTelemetry.
CMDB integrations dashboard
The Integration Commons for CMDB store app provides a dashboard with a central view of the status, processing results, and processing errors of all installed integrations. You can see metrics for all integration runs. You can filter the view to a specific CMDB integration, a specific time duration, or a specific integration run. For more details about monitoring Cloud Observability integrations in the CMDB Integrations Dashboard, see Using the CMDB Integrations Dashboard.
Data mapping
Data from the Cloud Observability data sources is mapped and transformed into the ServiceNow CMDB configuration item (CI) class definitions using the Robust Transform Engine (RTE). Data is inserted into the ServiceNow CMDB using the Identification and Reconciliation Engine (IRE).
When you complete setting up the connection, you can configure the integration to pull data from the application periodically.
The following table describes the data sources, the scheduled jobs, the staging tables, and the target tables as CMDB CI classes for the Cloud Observability application.
| Data source | Description | Scheduled job | Staging table | CMDB CI classes |
|---|---|---|---|---|
| OpenTelemetry Resources | Imports all the Kubernetes clusters, workloads, and application services from the OpenTelemetry traces. | OpenTelemetry ResourcesOpenTelemetry Delta Resources | OpenTelemetry Resources \[sn\_sg\_lightstep\_resources\] | Calculated Application Service Kubernetes Cluster Kubernetes Deployment Kubernetes Node Kubernetes Pod Kubernetes StatefulSet Kubernetes ReplicaSet Kubernetes DaemonSet Kubernetes Job Kubernetes Cronjob Kubernetes Namespace Server Key Value |
| OpenTelemetry Pods | Imports all the Kubernetes pods from the containers. | OpenTelemetry PodsOpenTelemetry Delta Pods | OpenTelemetry K8s Pods \[sn\_sg\_lightstep\_pods\] | Kubernetes Cluster Kubernetes Pod |
| OpenTelemetry Containers | Imports all the containers from the OpenTelemetry traces. | OpenTelemetry ContainersOpenTelemetry Delta Containers | OpenTelemetry docker containers \[sn\_sg\_lightstep\_containers\] | Docker Container |
| OpenTelemetry Container Images | Imports all the container images from the OpenTelemetry traces. | OpenTelemetry Container ImagesOpenTelemetry Delta Container Images | Opentelemetry container images \[sn\_sg\_lightstep\_container\_images\] | Docker Image |
| OpenTelemetry Services | Imports all the Kubernetes services from the OpenTelemetry traces. | OpenTelemetry Delta ServicesOpenTelemetry Services | OpenTelemetry K8s Services \[sn\_sg\_lightstep\_kubernetes\_services\] | Kubernetes Service |
| OpenTelemetry Dependency Map | Imports the dependency maps to get an aggregate view of the traced data.The data source also imports and loads any inferred services and their related services data in the Inferred service [sn_sg_lightstep_inferred_service] staging table. Note: You need to link the imported inferred services with a CI manually. See Inferred service linking. | OpenTelemetry Dependency Map | OpenTelemetry Dependency Map \[sn\_sg\_lightstep\_dependency\_map\] | Calculated Application Service |
For more information on where data is saved when pulling data from Cloud Observability, see CMDB classes targeted in Service Graph Connector for OpenTelemetry.
You can use the IntegrationHub ETL app to view the data maps. See IntegrationHub ETL for more information.
Inferred service linking
The ServiceNow Cloud Observability application can infer the presence of an inferred service when the span calling the remote service has the necessary information. Service Graph Connector for OpenTelemetry provides the linking of inferred services and their related services with CIs in the CMDB. For more information, see Linking inferred services with CIs.
Related topics