A valid monitor definition in the same format as the V1 Monitor API.
tags [required]
[string]
The definition of MonitorUserTemplateTags object.
template_variables
[object]
The definition of MonitorUserTemplateTemplateVariables object.
available_values
[string]
Available values for the variable.
defaults
[string]
Default values of the template variable.
name [required]
string
The name of the template variable.
tag_key
string
The tag key associated with the variable. This works the same as dashboard template variables.
title [required]
string
The title of the monitor user template.
type [required]
enum
Monitor user template resource type.
Allowed enum values: monitor-user-template
default: monitor-user-template
{"data":{"attributes":{"description":"A description.","monitor_definition":{"message":"A msg.","name":"A name example-monitor","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100","type":"query alert"},"tags":["integration:Azure"],"template_variables":[{"available_values":["value1","value2"],"defaults":["defaultValue"],"name":"regionName","tag_key":"datacenter"}],"title":"Postgres DB example-monitor"},"type":"monitor-user-template"}}
The last modified timestamp. When the template version was created.
monitor_definition
object
A valid monitor definition in the same format as the V1 Monitor API.
tags
[string]
The definition of MonitorUserTemplateTags object.
template_variables
[object]
The definition of MonitorUserTemplateTemplateVariables object.
available_values
[string]
Available values for the variable.
defaults
[string]
Default values of the template variable.
name [required]
string
The name of the template variable.
tag_key
string
The tag key associated with the variable. This works the same as dashboard template variables.
title
string
The title of the monitor user template.
version
int64
The version of the monitor user template.
id
string
The unique identifier.
type
enum
Monitor user template resource type.
Allowed enum values: monitor-user-template
default: monitor-user-template
{"data":{"attributes":{"created":"2024-01-02T03:04:23.274966+00:00","description":"This is a template for monitoring user activity.","modified":"2024-02-02T03:04:23.274966+00:00","monitor_definition":{"message":"You may need to add web hosts if this is consistently high.","name":"Bytes received on host0","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100","type":"query alert"},"tags":["product:Our Custom App","integration:Azure"],"template_variables":[{"available_values":["value1","value2"],"defaults":["defaultValue"],"name":"regionName","tag_key":"datacenter"}],"title":"Postgres CPU Monitor","version":0},"id":"00000000-0000-1234-0000-000000000000","type":"monitor-user-template"}}
## default
#
# Curl command curl-XPOST"https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/monitor/template" \
-H"Accept: application/json" \
-H"Content-Type: application/json" \
-H"DD-API-KEY: ${DD_API_KEY}" \
-H"DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d@-<<EOF{
"data": {
"attributes": {
"description": "This is a template for monitoring user activity.",
"monitor_definition": {
"message": "You may need to add web hosts if this is consistently high.",
"name": "Bytes received on host0",
"query": "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} \u003e 100",
"type": "query alert"
},
"tags": [
"product:Our Custom App",
"integration:Azure"
],
"template_variables": [
{
"available_values": [
"value1",
"value2"
],
"defaults": [
"defaultValue"
],
"name": "regionName",
"tag_key": "datacenter"
}
],
"title": "Postgres CPU Monitor"
},
"type": "monitor-user-template"
}
}EOF
// Create a monitor user template returns "OK" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){body:=datadogV2.MonitorUserTemplateCreateRequest{Data:datadogV2.MonitorUserTemplateCreateData{Attributes:datadogV2.MonitorUserTemplateRequestAttributes{Description:*datadog.NewNullableString(datadog.PtrString("A description.")),MonitorDefinition:map[string]interface{}{"message":"A msg.","name":"A name example-monitor","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100","type":"query alert",},Tags:[]string{"integration:Azure",},TemplateVariables:[]datadogV2.MonitorUserTemplateTemplateVariablesItems{{AvailableValues:[]string{"value1","value2",},Defaults:[]string{"defaultValue",},Name:"regionName",TagKey:datadog.PtrString("datacenter"),},},Title:"Postgres DB example-monitor",},Type:datadogV2.MONITORUSERTEMPLATERESOURCETYPE_MONITOR_USER_TEMPLATE,},}ctx:=datadog.NewDefaultContext(context.Background())configuration:=datadog.NewConfiguration()configuration.SetUnstableOperationEnabled("v2.CreateMonitorUserTemplate",true)apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewMonitorsApi(apiClient)resp,r,err:=api.CreateMonitorUserTemplate(ctx,body)iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `MonitorsApi.CreateMonitorUserTemplate`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `MonitorsApi.CreateMonitorUserTemplate`:\n%s\n",responseContent)}
"""
Create a monitor user template returns "OK" response
"""fromdatadog_api_clientimportApiClient,Configurationfromdatadog_api_client.v2.api.monitors_apiimportMonitorsApifromdatadog_api_client.v2.model.monitor_user_template_create_dataimportMonitorUserTemplateCreateDatafromdatadog_api_client.v2.model.monitor_user_template_create_requestimportMonitorUserTemplateCreateRequestfromdatadog_api_client.v2.model.monitor_user_template_request_attributesimportMonitorUserTemplateRequestAttributesfromdatadog_api_client.v2.model.monitor_user_template_resource_typeimportMonitorUserTemplateResourceTypefromdatadog_api_client.v2.model.monitor_user_template_template_variables_itemsimport(MonitorUserTemplateTemplateVariablesItems,)body=MonitorUserTemplateCreateRequest(data=MonitorUserTemplateCreateData(attributes=MonitorUserTemplateRequestAttributes(description="A description.",monitor_definition=dict([("message","A msg."),("name","A name example-monitor"),("query","avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"),("type","query alert"),]),tags=["integration:Azure",],template_variables=[MonitorUserTemplateTemplateVariablesItems(available_values=["value1","value2",],defaults=["defaultValue",],name="regionName",tag_key="datacenter",),],title="Postgres DB example-monitor",),type=MonitorUserTemplateResourceType.MONITOR_USER_TEMPLATE,),)configuration=Configuration()configuration.unstable_operations["create_monitor_user_template"]=TruewithApiClient(configuration)asapi_client:api_instance=MonitorsApi(api_client)response=api_instance.create_monitor_user_template(body=body)print(response)
# Create a monitor user template returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.unstable_operations["v2.create_monitor_user_template".to_sym]=trueendapi_instance=DatadogAPIClient::V2::MonitorsAPI.newbody=DatadogAPIClient::V2::MonitorUserTemplateCreateRequest.new({data:DatadogAPIClient::V2::MonitorUserTemplateCreateData.new({attributes:DatadogAPIClient::V2::MonitorUserTemplateRequestAttributes.new({description:"A description.",monitor_definition:{"message":"A msg.","name":"A name example-monitor","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100","type":"query alert",},tags:["integration:Azure",],template_variables:[DatadogAPIClient::V2::MonitorUserTemplateTemplateVariablesItems.new({available_values:["value1","value2",],defaults:["defaultValue",],name:"regionName",tag_key:"datacenter",}),],title:"Postgres DB example-monitor",}),type:DatadogAPIClient::V2::MonitorUserTemplateResourceType::MONITOR_USER_TEMPLATE,}),})papi_instance.create_monitor_user_template(body)
// Create a monitor user template returns "OK" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_monitors::MonitorsAPI;usedatadog_api_client::datadogV2::model::MonitorUserTemplateCreateData;usedatadog_api_client::datadogV2::model::MonitorUserTemplateCreateRequest;usedatadog_api_client::datadogV2::model::MonitorUserTemplateRequestAttributes;usedatadog_api_client::datadogV2::model::MonitorUserTemplateResourceType;usedatadog_api_client::datadogV2::model::MonitorUserTemplateTemplateVariablesItems;useserde_json::Value;usestd::collections::BTreeMap;#[tokio::main]asyncfnmain(){letbody=MonitorUserTemplateCreateRequest::new(MonitorUserTemplateCreateData::new(MonitorUserTemplateRequestAttributes::new(BTreeMap::from([("message".to_string(),Value::from("A msg.")),("name".to_string(),Value::from("A name example-monitor")),("query".to_string(),Value::from("avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"),),("type".to_string(),Value::from("query alert")),]),vec!["integration:Azure".to_string()],"Postgres DB example-monitor".to_string(),).description(Some("A description.".to_string())).template_variables(vec![MonitorUserTemplateTemplateVariablesItems::new("regionName".to_string(),).available_values(vec!["value1".to_string(),"value2".to_string()]).defaults(vec!["defaultValue".to_string()]).tag_key("datacenter".to_string())]),MonitorUserTemplateResourceType::MONITOR_USER_TEMPLATE,));letmutconfiguration=datadog::Configuration::new();configuration.set_unstable_operation_enabled("v2.CreateMonitorUserTemplate",true);letapi=MonitorsAPI::with_config(configuration);letresp=api.create_monitor_user_template(body).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<API-KEY>"DD_APP_KEY="<APP-KEY>"cargo run
/**
* Create a monitor user template returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration();configuration.unstableOperations["v2.createMonitorUserTemplate"]=true;constapiInstance=newv2.MonitorsApi(configuration);constparams: v2.MonitorsApiCreateMonitorUserTemplateRequest={body:{data:{attributes:{description:"A description.",monitorDefinition:{message:"A msg.",name:"A name example-monitor",query:"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100",type:"query alert",},tags:["integration:Azure"],templateVariables:[{availableValues:["value1","value2"],defaults:["defaultValue"],name:"regionName",tagKey:"datacenter",},],title:"Postgres DB example-monitor",},type:"monitor-user-template",},},};apiInstance.createMonitorUserTemplate(params).then((data: v2.MonitorUserTemplateCreateResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));