Skip to content

Commit 1c75143

Browse files
[9.0] [DOCS] Update URLs for apm, monitoring, and observability (#218030) (#220606)
# Backport This will backport the following commits from `main` to `9.0`: - [[DOCS] Update URLs for apm, monitoring, and observability (#218030)](#218030) <!--- Backport version: 9.6.6 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sorenlouv/backport) <!--BACKPORT [{"author":{"name":"Lisa Cawley","email":"[email protected]"},"sourceCommit":{"committedDate":"2025-05-09T00:29:43Z","message":"[DOCS] Update URLs for apm, monitoring, and observability (#218030)\n\n\nCo-authored-by: florent-leborgne <[email protected]>","sha":"d91af7ad7dbf702effb1602e746c401d492fd2f5","branchLabelMapping":{"^v9.1.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","ci:project-deploy-observability","backport:version","v9.1.0","v9.0.1"],"title":"[DOCS] Update URLs for apm, monitoring, and observability","number":218030,"url":"https://github.com/elastic/kibana/pull/218030","mergeCommit":{"message":"[DOCS] Update URLs for apm, monitoring, and observability (#218030)\n\n\nCo-authored-by: florent-leborgne <[email protected]>","sha":"d91af7ad7dbf702effb1602e746c401d492fd2f5"}},"sourceBranch":"main","suggestedTargetBranches":["9.0"],"targetPullRequestStates":[{"branch":"main","label":"v9.1.0","branchLabelMappingKey":"^v9.1.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/218030","number":218030,"mergeCommit":{"message":"[DOCS] Update URLs for apm, monitoring, and observability (#218030)\n\n\nCo-authored-by: florent-leborgne <[email protected]>","sha":"d91af7ad7dbf702effb1602e746c401d492fd2f5"}},{"branch":"9.0","label":"v9.0.1","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}] BACKPORT--> Co-authored-by: florent-leborgne <[email protected]>
1 parent c0d29b9 commit 1c75143

File tree

4 files changed

+53
-91
lines changed

4 files changed

+53
-91
lines changed

oas_docs/output/kibana.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -272,7 +272,7 @@ tags:
272272
x-displayName: Upgrade assistant
273273
- externalDocs:
274274
description: Uptime monitoring
275-
url: https://www.elastic.co/guide/en/observability/current/uptime-intro.html
275+
url: https://www.elastic.co/docs/solutions/observability/uptime
276276
name: uptime
277277
x-displayName: Uptime
278278
- name: user session

src/platform/packages/shared/kbn-doc-links/src/get_doc_links.ts

Lines changed: 50 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,7 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
3434
const KIBANA_APIS = `${API_DOCS}doc/kibana/v9/`;
3535
const KIBANA_SERVERLESS_APIS = `{$API_DOCS}doc/serverless/`;
3636
const FLEET_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/fleet/${DOC_LINK_VERSION}/`;
37-
const INTEGRATIONS_DEV_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/integrations-developer/current/`;
3837
const PLUGIN_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/elasticsearch/plugins/${DOC_LINK_VERSION}/`;
39-
const OBSERVABILITY_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/observability/${DOC_LINK_VERSION}/`;
4038
const SECURITY_SOLUTION_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/security/${DOC_LINK_VERSION}/`;
4139
const ENTERPRISE_SEARCH_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/enterprise-search/${DOC_LINK_VERSION}/`;
4240
const ESRE_DOCS = `${ELASTIC_WEBSITE_URL}guide/en/esre/${DOC_LINK_VERSION}/`;
@@ -56,29 +54,19 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
5654
upgradingStackOnCloud: `${ELASTIC_DOCS}deploy-manage/upgrade/deployment-or-cluster`,
5755
},
5856
apm: {
59-
kibanaSettings: `${KIBANA_DOCS}apm-settings-in-kibana.html`,
60-
supportedServiceMaps: isServerless
61-
? `${SERVERLESS_DOCS}observability-apm-service-map.html#observability-apm-service-map-supported-apm-agents`
62-
: `${KIBANA_DOCS}service-maps.html#service-maps-supported`,
63-
customLinks: isServerless
64-
? `${SERVERLESS_DOCS}observability-apm-create-custom-links.html`
65-
: `${KIBANA_DOCS}custom-links.html`,
66-
droppedTransactionSpans: `${OBSERVABILITY_DOCS}apm-data-model-spans.html#apm-data-model-dropped-spans`,
67-
upgrading: `${OBSERVABILITY_DOCS}apm-upgrade.html`,
68-
metaData: `${OBSERVABILITY_DOCS}apm-data-model-metadata.html`,
69-
overview: `${OBSERVABILITY_DOCS}apm.html`,
70-
tailSamplingPolicies: isServerless
71-
? `${SERVERLESS_DOCS}observability-apm-transaction-sampling.html`
72-
: `${OBSERVABILITY_DOCS}configure-tail-based-sampling.html`,
73-
elasticAgent: `${OBSERVABILITY_DOCS}/apm-upgrade-to-apm-integration.html`,
74-
storageExplorer: `${KIBANA_DOCS}storage-explorer.html`,
75-
spanCompression: isServerless
76-
? `${SERVERLESS_DOCS}observability-apm-compress-spans.html`
77-
: `${OBSERVABILITY_DOCS}apm-data-model-spans.html#apm-spans-span-compression`,
78-
transactionSampling: isServerless
79-
? `${SERVERLESS_DOCS}observability-apm-transaction-sampling.html`
80-
: `${OBSERVABILITY_DOCS}sampling.html`,
81-
indexLifecycleManagement: `${OBSERVABILITY_DOCS}apm-ilm-how-to.html`,
57+
kibanaSettings: `${ELASTIC_DOCS}solutions/observability/apm/applications-ui-settings`,
58+
supportedServiceMaps: `${ELASTIC_DOCS}solutions/observability/apm/service-map`,
59+
customLinks: `${ELASTIC_DOCS}solutions/observability/apm/create-custom-links`,
60+
droppedTransactionSpans: `${ELASTIC_DOCS}solutions/observability/apm/spans#apm-data-model-dropped-spans`,
61+
upgrading: `${ELASTIC_DOCS}solutions/observability/apm/upgrade`,
62+
metaData: `${ELASTIC_DOCS}solutions/observability/apm/metadata`,
63+
overview: `${ELASTIC_DOCS}solutions/observability/apm`,
64+
tailSamplingPolicies: `${ELASTIC_DOCS}solutions/observability/apm/transaction-sampling`,
65+
elasticAgent: `${ELASTIC_DOCS}solutions/observability/apm/switch-to-elastic-apm-integration`,
66+
storageExplorer: `${ELASTIC_DOCS}solutions/observability/apm/storage-explorer`,
67+
spanCompression: `${ELASTIC_DOCS}solutions/observability/apm/spans`,
68+
transactionSampling: `${ELASTIC_DOCS}solutions/observability/apm/transaction-sampling`,
69+
indexLifecycleManagement: `${ELASTIC_DOCS}solutions/observability/apm/index-lifecycle-management`,
8270
},
8371
canvas: {
8472
guide: `${ELASTIC_DOCS}explore-analyze/visualize/canvas`,
@@ -573,51 +561,27 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
573561
tsvbIndexPatternMode: `${ELASTIC_DOCS}explore-analyze/visualize/legacy-editors/tsvb#tsvb-data-view-mode`,
574562
},
575563
observability: {
576-
guide: isServerless
577-
? `${SERVERLESS_DOCS}what-is-observability-serverless.html`
578-
: `${OBSERVABILITY_DOCS}index.html`,
579-
infrastructureThreshold: `${OBSERVABILITY_DOCS}infrastructure-threshold-alert.html`,
580-
logsThreshold: `${OBSERVABILITY_DOCS}logs-threshold-alert.html`,
581-
metricsThreshold: `${OBSERVABILITY_DOCS}metrics-threshold-alert.html`,
582-
customThreshold: isServerless
583-
? `${SERVERLESS_DOCS}observability-create-custom-threshold-alert-rule.html`
584-
: `${OBSERVABILITY_DOCS}custom-threshold-alert.html`,
585-
monitorStatus: `${OBSERVABILITY_DOCS}monitor-status-alert.html`,
586-
monitorUptime: isServerless
587-
? `${SERVERLESS_DOCS}observability-monitor-synthetics.html`
588-
: `${OBSERVABILITY_DOCS}monitor-uptime.html`,
589-
tlsCertificate: `${OBSERVABILITY_DOCS}tls-certificate-alert.html`,
590-
uptimeDurationAnomaly: `${OBSERVABILITY_DOCS}duration-anomaly-alert.html`,
591-
monitorLogs: isServerless
592-
? `${SERVERLESS_DOCS}observability-discover-and-explore-logs.html`
593-
: `${OBSERVABILITY_DOCS}monitor-logs.html`,
594-
analyzeMetrics: isServerless
595-
? `${SERVERLESS_DOCS}observability-infrastructure-monitoring.html`
596-
: `${OBSERVABILITY_DOCS}analyze-metrics.html`,
597-
monitorUptimeSynthetics: isServerless
598-
? `${SERVERLESS_DOCS}observability-monitor-synthetics.html`
599-
: `${OBSERVABILITY_DOCS}monitor-uptime-synthetics.html`,
600-
userExperience: `${OBSERVABILITY_DOCS}user-experience.html`,
601-
createAlerts: isServerless
602-
? `${SERVERLESS_DOCS}observability-alerting.html`
603-
: `${OBSERVABILITY_DOCS}create-alerts.html`,
604-
syntheticsAlerting: isServerless
605-
? `${SERVERLESS_DOCS}observability-synthetics-settings.html#synthetics-settings-alerting`
606-
: `${OBSERVABILITY_DOCS}synthetics-settings.html#synthetics-settings-alerting`,
607-
syntheticsCommandReference: isServerless
608-
? `${SERVERLESS_DOCS}observability-synthetics-configuration.html#synthetics-configuration-playwright-options`
609-
: `${OBSERVABILITY_DOCS}synthetics-configuration.html#synthetics-configuration-playwright-options`,
610-
syntheticsProjectMonitors: isServerless
611-
? `${SERVERLESS_DOCS}observability-synthetics-get-started-project.html`
612-
: `${OBSERVABILITY_DOCS}synthetic-run-tests.html#synthetic-monitor-choose-project`,
613-
syntheticsMigrateFromIntegration: `${OBSERVABILITY_DOCS}synthetics-migrate-from-integration.html`,
614-
slo: isServerless
615-
? `${SERVERLESS_DOCS}observability-slos.html`
616-
: `${OBSERVABILITY_DOCS}slo.html`,
617-
sloBurnRateRule: isServerless
618-
? `${SERVERLESS_DOCS}observability-create-slo-burn-rate-alert-rule.html`
619-
: `${OBSERVABILITY_DOCS}slo-burn-rate-alert.html`,
620-
aiAssistant: `${OBSERVABILITY_DOCS}obs-ai-assistant.html`,
564+
guide: `${ELASTIC_DOCS}solutions/observability`,
565+
infrastructureThreshold: `${ELASTIC_DOCS}solutions/observability/incident-management/create-an-inventory-rule`,
566+
logsThreshold: `${ELASTIC_DOCS}solutions/observability/incident-management/create-log-threshold-rule`,
567+
metricsThreshold: `${ELASTIC_DOCS}solutions/observability/incident-management/create-metric-threshold-rule`,
568+
customThreshold: `${ELASTIC_DOCS}solutions/observability/incident-management/create-custom-threshold-rule`,
569+
monitorStatus: `${ELASTIC_DOCS}solutions/observability/incident-management/create-monitor-status-rule`,
570+
monitorUptime: `${ELASTIC_DOCS}solutions/observability/synthetics`,
571+
tlsCertificate: `${ELASTIC_DOCS}solutions/observability/incident-management/create-tls-certificate-rule`,
572+
uptimeDurationAnomaly: `${ELASTIC_DOCS}solutions/observability/incident-management/create-an-uptime-duration-anomaly-rule`,
573+
monitorLogs: `${ELASTIC_DOCS}solutions/observability/logs/explore-logs`,
574+
analyzeMetrics: `${ELASTIC_DOCS}solutions/observability/infra-and-hosts/analyze-infrastructure-host-metrics`,
575+
monitorUptimeSynthetics: `${ELASTIC_DOCS}solutions/observability/synthetics`,
576+
userExperience: `${ELASTIC_DOCS}solutions/observability/applications/user-experience`,
577+
createAlerts: `${ELASTIC_DOCS}solutions/observability/incident-management/alerting`,
578+
syntheticsAlerting: `${ELASTIC_DOCS}solutions/observability/synthetics/configure-settings#synthetics-settings-alerting`,
579+
syntheticsCommandReference: `${ELASTIC_DOCS}solutions/observability/synthetics/configure-projects#synthetics-configuration-playwright-options`,
580+
syntheticsProjectMonitors: `${ELASTIC_DOCS}solutions/observability/synthetics/create-monitors-with-projects`,
581+
syntheticsMigrateFromIntegration: `${ELASTIC_DOCS}solutions/observability/synthetics/migrate-from-elastic-synthetics-integration`,
582+
slo: `${ELASTIC_DOCS}solutions/observability/incident-management/service-level-objectives-slos`,
583+
sloBurnRateRule: `${ELASTIC_DOCS}solutions/observability/incident-management/create-an-slo-burn-rate-rule`,
584+
aiAssistant: `${ELASTIC_DOCS}solutions/observability/observability-ai-assistant`,
621585
},
622586
alerting: {
623587
guide: `${ELASTIC_DOCS}explore-analyze/alerts-cases/alerts/create-manage-rules`,
@@ -658,20 +622,20 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
658622
termJoinsExample: `${ELASTIC_DOCS}explore-analyze/visualize/maps/terms-join#_example_term_join`,
659623
},
660624
monitoring: {
661-
alertsKibana: `${KIBANA_DOCS}kibana-alerts.html`,
662-
alertsKibanaCpuThreshold: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-cpu-threshold`,
663-
alertsKibanaDiskThreshold: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-disk-usage-threshold`,
664-
alertsKibanaJvmThreshold: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-jvm-memory-threshold`,
665-
alertsKibanaMissingData: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-missing-monitoring-data`,
666-
alertsKibanaThreadpoolRejections: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-thread-pool-rejections`,
667-
alertsKibanaCCRReadExceptions: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-ccr-read-exceptions`,
668-
alertsKibanaLargeShardSize: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-large-shard-size`,
669-
alertsKibanaClusterAlerts: `${KIBANA_DOCS}kibana-alerts.html#kibana-alerts-cluster-alerts`,
670-
metricbeatBlog: `${ELASTIC_WEBSITE_URL}blog/external-collection-for-elastic-stack-monitoring-is-now-available-via-metricbeat`,
671-
monitorElasticsearch: `${ELASTICSEARCH_DOCS}configuring-metricbeat.html`,
672-
monitorKibana: `${KIBANA_DOCS}monitoring-metricbeat.html`,
673-
monitorLogstash: `${ELASTIC_WEBSITE_URL}guide/en/logstash/${DOC_LINK_VERSION}/monitoring-with-metricbeat.html`,
674-
troubleshootKibana: `${KIBANA_DOCS}monitor-troubleshooting.html`,
625+
alertsKibana: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts`,
626+
alertsKibanaCpuThreshold: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-cpu-threshold`,
627+
alertsKibanaDiskThreshold: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-disk-usage-threshold`,
628+
alertsKibanaJvmThreshold: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-jvm-memory-threshold`,
629+
alertsKibanaMissingData: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-missing-monitoring-data`,
630+
alertsKibanaThreadpoolRejections: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-thread-pool-rejections`,
631+
alertsKibanaCCRReadExceptions: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-ccr-read-exceptions`,
632+
alertsKibanaLargeShardSize: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-large-shard-size`,
633+
alertsKibanaClusterAlerts: `${ELASTIC_DOCS}deploy-manage/monitor/monitoring-data/configure-stack-monitoring-alerts#kibana-alerts-cluster-alerts`,
634+
metricbeatBlog: `https://www.elastic.co/blog/external-collection-for-elastic-stack-monitoring-is-now-available-via-metricbeat`,
635+
monitorElasticsearch: `${ELASTIC_DOCS}deploy-manage/monitor/stack-monitoring/collecting-monitoring-data-with-metricbeat`,
636+
monitorKibana: `${ELASTIC_DOCS}deploy-manage/monitor/stack-monitoring/kibana-monitoring-metricbeat`,
637+
monitorLogstash: `${ELASTIC_DOCS}reference/logstash/monitoring-with-metricbeat`,
638+
troubleshootKibana: `${ELASTIC_DOCS}troubleshoot/kibana/monitoring`,
675639
},
676640
reporting: {
677641
cloudMinimumRequirements: `${ELASTIC_DOCS}explore-analyze/report-and-share#_embed_outside_of_kib`,
@@ -901,7 +865,7 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
901865
httpMonitoring: `${FLEET_DOCS}agent-policy.html#change-policy-enable-agent-monitoring`,
902866
},
903867
integrationDeveloper: {
904-
upload: `${INTEGRATIONS_DEV_DOCS}upload-a-new-integration.html`,
868+
upload: `${ELASTIC_DOCS}extend/integrations/upload-new-integration`,
905869
},
906870
ecs: {
907871
guide: `${ELASTIC_WEBSITE_URL}guide/en/ecs/${ECS_VERSION}/index.html`,
@@ -998,9 +962,7 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
998962
apiKeyPrivileges: `${ELASTIC_DOCS}deploy-manage/api-keys/serverless-project-api-keys#api-keys-restrict-privileges`,
999963
},
1000964
synthetics: {
1001-
featureRoles: isServerless
1002-
? `${SERVERLESS_DOCS}observability-synthetics-feature-roles.html`
1003-
: `${OBSERVABILITY_DOCS}synthetics-feature-roles.html`,
965+
featureRoles: `${ELASTIC_DOCS}solutions/observability/synthetics/grant-access-to-secured-resources`,
1004966
},
1005967
telemetry: {
1006968
settings: `${ELASTIC_DOCS}reference/kibana/configuration-reference/telemetry-settings`,

src/platform/plugins/shared/ai_assistant_management/selection/public/routes/components/ai_assistant_selection_page.test.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ describe('AiAssistantSelectionPage', () => {
9595
renderComponent(testCapabilities);
9696
const docLink = screen.getByTestId('pluginsAiAssistantSelectionPageDocumentationLink');
9797
expect(docLink).toBeInTheDocument();
98-
expect(docLink.getAttribute('href')).toContain('obs-ai-assistant');
98+
expect(docLink.getAttribute('href')).toContain('observability-ai-assistant');
9999
});
100100
});
101101
});

x-pack/solutions/observability/plugins/uptime/docs/openapi/uptime_apis.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ tags:
1111
x-displayName: Uptime
1212
# description:
1313
externalDocs:
14-
url: https://www.elastic.co/guide/en/observability/current/uptime-intro.html
14+
url: https://www.elastic.co/docs/solutions/observability/uptime
1515
description: Uptime monitoring
1616
servers:
1717
- url: /

0 commit comments

Comments
 (0)