For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spa/get-spa-recommendations-v2.md. A documentation index is available at /llms.txt.
Language
Datadog site

Get SPA recommendations v2

WARNINGNote: This endpoint is in preview and may change in the future. It is not yet recommended for production use.
POSThttps://api.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.us3.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.us5.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.datadoghq.eu/api/v2/spa/recommendations-v2/{service}https://api.ap1.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.ap2.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.uk1.datadoghq.com/api/v2/spa/recommendations-v2/{service}https://api.ddog-gov.com/api/v2/spa/recommendations-v2/{service}https://api.us2.ddog-gov.com/api/v2/spa/recommendations-v2/{service}

Overview

This endpoint is experimental and restricted to Datadog internal use only. Retrieve resource recommendations for a Spark job. The caller (Spark Gateway) provides a service name and the job's raw arguments. SPA determines which arguments are relevant for the service and returns structured recommendations for driver and executor resources.

Arguments

Path Parameters

Name
Type
Description
service [required]
string

The service name for a Spark job

Request

Body Data (required)

Field
Type
Description
data [required]
object

JSON:API resource object for the SPA v2 recommendation request.

Response

OK

JSON:API document containing a single Recommendation resource. Returned by SPA when the Spark Gateway requests recommendations.

Field
Type
Description
data [required]
object

JSON:API resource object for SPA Recommendation. Includes type, optional ID, and resource attributes with structured recommendations.

Code Example

Get SPA recommendations v2
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF
# Path parameters
export service="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/spa/recommendations-v2/${service}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "arguments": [
        ""
      ]
    },
    "type": "recommendation_v2_request"
  }
}
EOF