turbot/pagerduty
steampipe plugin install pagerduty

Table: pagerduty_service_integration - Query PagerDuty Service Integrations using SQL

PagerDuty Service Integrations are connections between PagerDuty and various other systems, tools, and services. These integrations allow incidents to be triggered, acknowledged, and resolved within PagerDuty based on events occurring in the connected systems. They form a crucial part of incident management workflows, helping teams to respond quickly and effectively to operational issues.

Table Usage Guide

The pagerduty_service_integration table provides insights into the integrations between PagerDuty and other systems. As an incident manager, you can use this table to understand the sources of incidents within your PagerDuty environment, including the types of integrations, their configurations, and their associated services. This information can help you to optimize your incident response processes and ensure that your team has the necessary context to resolve incidents efficiently.

Examples

Basic info

Explore which PagerDuty service integrations have been created by analyzing their names, IDs, and creation dates. This can provide insights into your system's integration history and help you understand the vendor details associated with each service.

select
name,
id,
service_id,
created_at,
jsonb_pretty(vendor) as vendor
from
pagerduty_service_integration;
select
name,
id,
service_id,
created_at,
vendor
from
pagerduty_service_integration;

List all vendor specific integrations of a service

Discover the segments that have specific integrations with vendors for a service. This can be useful to identify and manage third-party dependencies and assess potential risks associated with vendor-specific integrations.

select
name,
id,
service_id,
created_at,
vendor ->> 'summary' as vendor_name
from
pagerduty_service_integration
where
vendor is not null;
select
name,
id,
service_id,
created_at,
json_extract(vendor, '$.summary') as vendor_name
from
pagerduty_service_integration
where
vendor is not null;

Schema for pagerduty_service_integration

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
created_attimestamp with time zoneThe date/time when this integration was created.
html_urltextAn URL at which the entity is uniquely displayed in the Web app.
idtext=An unique identifier of the integration.
integration_emailtextSpecify for generic_email_inbound_integration. Must be set to an email address @your-subdomain.pagerduty.com.
integration_keytextSpecify the integration key for the service integration.
nametextThe name of this integration.
selftextThe API show URL at which the object is accessible.
servicejsonbDescribes the information about the queried service.
service_idtext=An unique identifier of the queried service.
summarytextA short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
titletextTitle of the resource.
typetextThe type of object being created.
vendorjsonbDescribes the information about a specific type of integration.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- pagerduty

You can pass the configuration to the command with the --config argument:

steampipe_export_pagerduty --config '<your_config>' pagerduty_service_integration