Skip to content

Commit 08adb88

Browse files
HugoPctdomalessi
authored and
StefonSimmons
committed
add External Provider Status page to docs (#30875)
* add External Provider Status page to docs * add link to the in-app page * Apply suggestions from code review Co-authored-by: domalessi <[email protected]> * Update content/en/internal_developer_portal/external_provider_status.md Co-authored-by: domalessi <[email protected]> --------- Co-authored-by: domalessi <[email protected]>
1 parent 36d1ed4 commit 08adb88

File tree

5 files changed

+129
-0
lines changed

5 files changed

+129
-0
lines changed

‎config/_default/menus/main.en.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2144,6 +2144,11 @@ menu:
21442144
parent: idp_eng_reports
21452145
identifier: eng_reports_dora_metrics
21462146
weight: 403
2147+
- name: External Provider Status
2148+
url: internal_developer_portal/external_provider_status
2149+
parent: internal_developer_portal
2150+
identifier: external_provider_status
2151+
weight: 5
21472152
- name: Integrations
21482153
url: internal_developer_portal/integrations
21492154
parent: internal_developer_portal

‎content/en/internal_developer_portal/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ If you're new to IDP, start with the [Getting Started guide][5], which walks thr
5050
{{< nextlink href="/internal_developer_portal/scorecards" >}}Promote engineering best practices at scale with Scorecards{{< /nextlink >}}
5151
{{< nextlink href="/internal_developer_portal/self_service_actions" >}}Accelerate releases through Self-Service Actions{{< /nextlink >}}
5252
{{< nextlink href="/internal_developer_portal/eng_reports" >}}Track reliability and scorecard compliance with Engineering Reports{{< /nextlink >}}
53+
{{< nextlink href="/internal_developer_portal/external_provider_status" >}}Monitor external dependencies with External Provider Status{{< /nextlink >}}
5354
{{< /whatsnext >}}
5455

5556
## Working with teams

‎content/en/internal_developer_portal/external_provider_status.md

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
---
2+
title: External Provider Status
3+
further_reading:
4+
- link: "https://www.datadoghq.com/blog/watchdog-outage-detection/"
5+
tag: "Blog"
6+
text: "Stay ahead of service disruptions with Watchdog Cloud and API Outage Detection"
7+
- link: "watchdog/faulty_cloud_saas_api_detection/"
8+
tag: "Documentation"
9+
text: "Learn about Watchdog Faulty Cloud & SaaS API Detection"
10+
---
11+
12+
## Overview
13+
14+
The [External Provider Status page][1] provides real-time visibility into the operational status of third-party services such as payment gateways, cloud platforms, and APIs. Use this page to identify performance issues early, reduce mean time to detection (MTTD), and minimize the impact of provider disruptions.
15+
16+
{{< img src="internal_developer_portal/external_provider_status/external_provider_status_page.png" alt="External Provider Status page showing operational status of third-party dependencies" >}}
17+
18+
19+
## Key capabilities
20+
External Provider Status evaluates third-party service performance by monitoring service impact rather than relying on status page updates. It uses telemetry data from your applications for earlier and more accurate detection of external provider problems.
21+
22+
External Provider Status shows:
23+
24+
- **Real-time status**: Monitor external provider health in a single view.
25+
- **Service dependencies**: Map external providers to internal services (requires APM).
26+
- **Historical data**: View 90-day performance trends and incident history.
27+
- **Alerting**: Receive notifications when provider degradations occur.
28+
29+
## Configure notifications
30+
31+
To receive notifications for external provider degradations:
32+
33+
1. Click `Notify Me` in the upper right corner.
34+
2. Define the notification conditions:
35+
- Choose which provider(s) to monitor.
36+
- Choose when to be alerted for the selected provider(s):
37+
- Alert on any degradation.
38+
- Alert only when degradation impacts your services.
39+
3. Set your notification preferences.
40+
4. Name the notification rule.
41+
42+
{{< img src="internal_developer_portal/external_provider_status/external_provider_status_notifications.png" alt="Notification configuration modal for External Provider Status alerts" >}}
43+
44+
## Supported providers
45+
46+
External Provider Status monitors the following third-party providers:
47+
48+
49+
| External provider | API monitored |
50+
|----------|--------------------|
51+
| Amplitude | `api.amplitude.com` |
52+
| Atlassian | `*.atlassian.net` |
53+
| Auth0 | `*.auth0.com` |
54+
| Binance | `api.binance.com` |
55+
| Braintree | `api.braintreegateway.com` |
56+
| Coreweave | `*.coreweave.com` |
57+
| Cloudflare | `api.cloudflare.com` |
58+
| Confluent | `api.confluent.cloud`, `api.telemetry.confluent.cloud` |
59+
| Databricks | `*.cloud.databricks.com` |
60+
| Envoy | `api.envoy.com` |
61+
| Facebook | `graph.facebook.com` |
62+
| GitHub | `api.github.com` |
63+
| Hubspot | `api.hubspot.com` |
64+
| Intercom | `api.intercom.io` |
65+
| Mapbox | `api.mapbox.com` |
66+
| Mixpanel | `api.mixpanel.com` |
67+
| OpenAI | `*.openai.com` |
68+
| PagerDuty | `api.pagerduty.com` |
69+
| Palo Alto Networks | `api.urlcloud.paloaltonetworks.com` |
70+
| Render | `api.render.com` |
71+
| SendGrid | `*.sendgrid.com` |
72+
| ServiceNow | `*.service-now.com` |
73+
| Slack | `*.slack.com` |
74+
| Snowflake | `*.snowflakecomputing.com` |
75+
| SoundCloud | `api.soundcloud.com` |
76+
| Splunk | `*.splunkcloud.com` |
77+
| Square | `connect.squareup.com` |
78+
| Stripe | `api.stripe.com` |
79+
| Towerdata | `api.towerdata.com` |
80+
| Twilio | `api.twilio.com` |
81+
| Twitter | `api.twitter.com` |
82+
| Zendesk | `*.zendesk.com` |
83+
| Zoom | `api.zoom.us` |
84+
### AWS services
85+
86+
External Provider Status monitors the following AWS services through endpoints matching `*.amazonaws.com`:
87+
- CloudWatch
88+
- DynamoDB
89+
- ELB
90+
- ES
91+
- Firehose
92+
- Kinesis
93+
- KMS
94+
- Lambda
95+
- RDS
96+
- S3
97+
- SNS
98+
- SQS
99+
- STS
100+
101+
These services are monitored in the following regions:
102+
| AMER | EMEA | APAC |
103+
| --------------| -------------|----------------|
104+
| us-east-2 | af-south-1 | ap-east-1 |
105+
| us-east-1 | eu-central-1 | ap-south-2 |
106+
| us-west-1 | eu-west-1 | ap-southeast-3 |
107+
| us-west-2 | eu-west-2 | ap-southeast-4 |
108+
| ca-central-1 | eu-south-1 | ap-south-1 |
109+
| ca-west-1 | eu-west-3 | ap-northeast-3 |
110+
| us-gov-east-1 | eu-south-2 | ap-northeast-2 |
111+
| us-gov-west-1 | eu-north-1 | ap-southeast-1 |
112+
| sa-east-1 | eu-central-2 | ap-southeast-2 |
113+
| | me-south-1 | ap-northeast-1 |
114+
| | me-central-1 | |
115+
| | il-central-1 | |
116+
117+
## Further Reading
118+
119+
{{< partial name="whats-next/whats-next.html" >}}
120+
121+
[1]: https://app.datadoghq.com/watchdog/external-provider-status
122+
123+

‎static/images/internal_developer_portal/external_provider_status/external_provider_status_notifications.png

429 KB
Loading

‎static/images/internal_developer_portal/external_provider_status/external_provider_status_page.png

443 KB
Loading

0 commit comments

Comments
 (0)