Merge branch '2.5.x' into 2.6.x

Closes gh-30996

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/datadog/DatadogProperties.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2020 the original author or authors.
+ * Copyright 2012-2022 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -53,8 +53,8 @@ public class DatadogProperties extends StepRegistryProperties {
 	private String hostTag = "instance";
 
 	/**
-	 * URI to ship metrics to. If you need to publish metrics to an internal proxy
+	 * URI to ship metrics to. Set this if you need to publish metrics to a Datadog site
-	 * en-route to Datadog, you can define the location of the proxy with this.
+	 * other than US, or to an internal proxy en-route to Datadog.
 	 */
 	private String uri = "https://api.datadoghq.com";
 

spring-boot-project/spring-boot-docs/src/docs/asciidoc/actuator/metrics.adoc

@@ -133,6 +133,30 @@ To export metrics to {micrometer-registry-docs}/datadog[Datadog], you must provi
 	        api-key: "YOUR_KEY"
 ----
 
+If you additionally provide an application key (optional), then metadata such as meter descriptions, types, and base units will also be exported:
+
+[source,yaml,indent=0,subs="verbatim",configprops,configblocks]
+----
+	management:
+	  metrics:
+	    export:
+	      datadog:
+	        api-key: "YOUR_API_KEY"
+	        application-key: "YOUR_APPLICATION_KEY"
+----
+
+By default, metrics are sent to the Datadog US https://docs.datadoghq.com/getting_started/site[site] (`https://api.datadoghq.com`).
+If your Datadog project is hosted on one of the other sites, or you need to send metrics through a proxy, configure the URI accordingly:
+
+[source,yaml,indent=0,subs="verbatim",configprops,configblocks]
+----
+	management:
+	  metrics:
+	    export:
+	      datadog:
+	        uri: "https://api.datadoghq.eu"
+----
+
 You can also change the interval at which metrics are sent to Datadog:
 
 [source,yaml,indent=0,subs="verbatim",configprops,configblocks]