diff --git a/config.toml b/config.toml
index 0998e8150e7e..4a26c87dbcc1 100644
--- a/config.toml
+++ b/config.toml
@@ -154,6 +154,11 @@ pygmentsUseClasses = true
name = "cloudflare"
url = "/docs/reference/pkg/nodejs/pulumi/cloudflare/"
+[[menu.reference]]
+ parent = "node"
+ name = "datadog"
+ url = "/docs/reference/pkg/nodejs/pulumi/datadog/"
+
[[menu.reference]]
parent = "node"
name = "digitalocean"
@@ -261,6 +266,11 @@ pygmentsUseClasses = true
name = "pulumi_cloudflare"
url = "/docs/reference/pkg/python/pulumi_cloudflare/"
+[[menu.reference]]
+ parent = "python"
+ name = "pulumi_datadog"
+ url = "/docs/reference/pkg/python/pulumi_datadog/"
+
[[menu.reference]]
parent = "python"
name = "pulumi_digitalocean"
diff --git a/content/docs/reference/cd-aws-code-services.md b/content/docs/reference/cd-aws-code-services.md
index efb9276ee606..5e5e6f0a2e2f 100644
--- a/content/docs/reference/cd-aws-code-services.md
+++ b/content/docs/reference/cd-aws-code-services.md
@@ -26,8 +26,8 @@ named `PULUMI_ACCESS_TOKEN`. This is required to authenticate with pulumi.com in
an update. You can create a new Pulumi access token specifically for your CloudBuild project on
your [Pulumi Account page](https://app.pulumi.com/account/tokens).
-Because of the sensitive nature of the access token, it is recommended that the the Pulumi access
-token in Amazon's Systems Manager Parameter Store. This allows you to keep the value secret, while
+Because of the sensitive nature of the access token, it is recommended that the Pulumi access
+token be stored in Amazon's Systems Manager (SSM) Parameter Store. This allows you to keep the value secret, while
providing auditable access to CodeBuild.
### Service Role
diff --git a/content/docs/reference/crosswalk/aws/_index.md b/content/docs/reference/crosswalk/aws/_index.md
index 4568812d409b..83b5b3fb6d06 100644
--- a/content/docs/reference/crosswalk/aws/_index.md
+++ b/content/docs/reference/crosswalk/aws/_index.md
@@ -69,7 +69,7 @@ relevant User Guides to get started:
### Containers
* [Elastic Container Service (ECS)]({{< relref "ecs.md" >}})
-* [Elastic Container Service for Kubernetes (EKS)]({{< relref "eks.md" >}})
+* [Elastic Kubernetes Service (EKS)]({{< relref "eks.md" >}})
* [Elastic Container Registry (ECR)]({{< relref "ecr.md" >}})
### Serverless
diff --git a/content/docs/reference/crosswalk/aws/eks.md b/content/docs/reference/crosswalk/aws/eks.md
index d43e68a94b6d..4ac9e5f767f2 100644
--- a/content/docs/reference/crosswalk/aws/eks.md
+++ b/content/docs/reference/crosswalk/aws/eks.md
@@ -1,5 +1,5 @@
---
-title: "AWS Elastic Container Service for Kubernetes (EKS)"
+title: "AWS Elastic Kubernetes Service (EKS)"
menu:
reference:
parent: crosswalk-aws
@@ -11,7 +11,7 @@ menu:
-[Amazon Elastic Container Service for Kubernetes (Amazon EKS)](https://aws.amazon.com/eks) makes it easy to deploy,
+[Amazon Elastic Kubernetes Service (Amazon EKS)](https://aws.amazon.com/eks) makes it easy to deploy,
manage, and scale containerized applications using Kubernetes on AWS. Amazon EKS runs the Kubernetes management
infrastructure for you across multiple AWS availability zones to eliminate a single point of failure. Amazon EKS is
certified Kubernetes conformant so you can use existing tooling and plugins from partners and the Kubernetes
@@ -731,5 +731,5 @@ For more information about Kubernetes and EKS, please see the following:
* [Pulumi Kubernetes API Documentation]({{< relref "/docs/reference/pkg/nodejs/pulumi/kubernetes" >}})
* [Pulumi EKS API Documentation]({{< relref "/docs/reference/pkg/nodejs/pulumi/eks/_index.md" >}})
-* [Amazon Elastic Container Service for Kubernetes homepage](https://aws.amazon.com/eks/)
+* [Amazon Elastic Kubernetes Service homepage](https://aws.amazon.com/eks/)
* [Kubernetes Documentation](https://kubernetes.io)
diff --git a/content/docs/reference/crosswalk/aws/other.md b/content/docs/reference/crosswalk/aws/other.md
index 1e7554e83474..e99fd36ecc33 100644
--- a/content/docs/reference/crosswalk/aws/other.md
+++ b/content/docs/reference/crosswalk/aws/other.md
@@ -89,7 +89,7 @@ tbody tr td:first-child {
| [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/) | Private container registries | [User Guide]({{< relref "ecr.md" >}}) | [ecr]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/ecr/_index.md" >}}) |
| [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/) | Run containerized apps | [User Guide]({{< relref "ecs.md" >}}) | [ecs]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/ecs/_index.md" >}}) |
| [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/) | Scalable, elastic file system | | [efs]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/efs/_index.md" >}}) |
-| [Amazon Elastic Container Service for Kubernetes (EKS)](https://aws.amazon.com/eks/) | Managed Kubernetes service | [User Guide]({{< relref "eks.md" >}}) | [eks]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/eks/_index.md" >}}) |
+| [Amazon Elastic Kubernetes Service (EKS)](https://aws.amazon.com/eks/) | Managed Kubernetes service | [User Guide]({{< relref "eks.md" >}}) | [eks]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/eks/_index.md" >}}) |
| [Amazon ElastiCache](https://aws.amazon.com/elasticache/) | Managed Redis or Memcached service | | [elasticache]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/elasticache/_index.md" >}}) |
| [AWS Elastic Beanstalk](https://aws.amazon.com/elasticbeanstalk/) | Deploy and scale web apps | | [elasticbeanstalk]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/elasticbeanstalk/_index.md" >}}) |
| [AWS Elastic Load Balancing (ELB)](https://aws.amazon.com/elasticloadbalancing/) | Scale across many instances | [User Guide]({{< relref "elb.md" >}}) | [elasticloadbalancingv2]({{< relref "/docs/reference/pkg/nodejs/pulumi/aws/elasticloadbalancingv2/_index.md" >}}) |
diff --git a/content/docs/reference/pkg/nodejs/pulumi/datadog/_index.md b/content/docs/reference/pkg/nodejs/pulumi/datadog/_index.md
new file mode 100644
index 000000000000..4bd536207b5e
--- /dev/null
+++ b/content/docs/reference/pkg/nodejs/pulumi/datadog/_index.md
@@ -0,0 +1,4287 @@
+---
+title: Package @pulumi/datadog
+---
+
+
+
+
+
+{{< langchoose nodeonly >}}
+
+```javascript
+var datadog = require("@pulumi/datadog");
+```
+
+```typescript
+import * as datadog from "@pulumi/datadog";
+```
+
+
+
extends CustomResource+{{% md %}} + +Provides a Datadog downtime resource. This can be used to create and manage Datadog downtimes. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new daily 1700-0900 Datadog downtime +const foo = new datadog.Downtime("foo", { + end: 1483365600, + recurrence: { + period: 1, + type: "days", + }, + scopes: ["*"], + start: 1483308000, +}); +``` + +{{% /md %}} +
new Downtime(name: string, args: DowntimeArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a Downtime resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DowntimeState, opts?: pulumi.CustomResourceOptions): Downtime+ + +Get an existing Downtime resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Downtime. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public active: pulumi.Output<boolean | undefined>;+{{% md %}} + +A flag indicating if the downtime is active now. + +{{% /md %}} +
public disabled: pulumi.Output<boolean | undefined>;+{{% md %}} + +A flag indicating if the downtime was disabled. + +{{% /md %}} +
public end: pulumi.Output<number | undefined>;+{{% md %}} + +POSIX timestamp to end the downtime. + +{{% /md %}} +
public endDate: pulumi.Output<string | undefined>;+{{% md %}} + +String representing date and time to end the downtime in RFC3339 format. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public message: pulumi.Output<string | undefined>;+{{% md %}} + +A message to include with notifications for this downtime. + +{{% /md %}} +
public monitorId: pulumi.Output<number | undefined>;+{{% md %}} + +Reference to which monitor this downtime is applied. When scheduling downtime for a given monitor, datadog changes `silenced` property of the monitor to match the `end` POSIX timestamp. + +{{% /md %}} +
public monitorTags: pulumi.Output<string[] | undefined>;+{{% md %}} +{{% /md %}} +
public recurrence: pulumi.Output<{ + period: number; + type: string; + untilDate: undefined | number; + untilOccurrences: undefined | number; + weekDays: string[]; +} | undefined>;+{{% md %}} + +A dictionary to configure the downtime to be recurring. + +{{% /md %}} +
public scopes: pulumi.Output<string[]>;+{{% md %}} + +A list of items to apply the downtime to, e.g. host:X + +{{% /md %}} +
public start: pulumi.Output<number | undefined>;+{{% md %}} + +POSIX timestamp to start the downtime. + +{{% /md %}} +
public startDate: pulumi.Output<string | undefined>;+{{% md %}} + +String representing date and time to start the downtime in RFC3339 format. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog metric_metadata resource. This can be used to manage a metric's metadata. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Manage a Datadog metric's metadata +const requestTime = new datadog.MetricMetadata("request_time", { + description: "99th percentile request time in millseconds", + metric: "request.time", + shortName: "Request time", + type: "gauge", + unit: "millisecond", +}); +``` + +{{% /md %}} +
new MetricMetadata(name: string, args: MetricMetadataArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a MetricMetadata resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MetricMetadataState, opts?: pulumi.CustomResourceOptions): MetricMetadata+ + +Get an existing MetricMetadata resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of MetricMetadata. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public description: pulumi.Output<string | undefined>;+{{% md %}} + +A description of the metric. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public metric: pulumi.Output<string>;+{{% md %}} + +The name of the metric. + +{{% /md %}} +
public perUnit: pulumi.Output<string | undefined>;+{{% md %}} + +'Per' unit of the metric such as 'second' in 'bytes per second'. + +{{% /md %}} +
public shortName: pulumi.Output<string | undefined>;+{{% md %}} + +A short name of the metric. + +{{% /md %}} +
public statsdInterval: pulumi.Output<number | undefined>;+{{% md %}} + +If applicable, stasd flush interval in seconds for the metric. + +{{% /md %}} +
public type: pulumi.Output<string | undefined>;+{{% md %}} +{{% /md %}} +
public unit: pulumi.Output<string | undefined>;+{{% md %}} + +Primary unit of the metric such as 'byte' or 'operation'. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog monitor resource. This can be used to create and manage Datadog monitors. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog monitor +const foo = new datadog.Monitor("foo", { + escalationMessage: "Escalation message @pagerduty", + includeTags: true, + message: "Monitor triggered. Notify: @hipchat-channel", + name: "Name for monitor foo", + notifyAudit: false, + notifyNoData: false, + query: "avg(last_1h):avg:aws.ec2.cpu{environment:foo,host:foo} by {host} > 4", + renotifyInterval: 60, + silenced: { + "*": 0, + }, + tags: [ + "foo:bar", + "baz", + ], + thresholds: { + critical: 4, + critical_recovery: 3, + ok: 0, + warning: 2, + warning_recovery: 1, + }, + timeoutH: 60, + type: "metric alert", +}); +``` + +{{% /md %}} +
new Monitor(name: string, args: MonitorArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a Monitor resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MonitorState, opts?: pulumi.CustomResourceOptions): Monitor+ + +Get an existing Monitor resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Monitor. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public enableLogsSample: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether or not to include a list of log values which triggered the alert. Defaults to false. This is only used by log monitors. +triggering tags into the title. Defaults to true. + +{{% /md %}} +
public escalationMessage: pulumi.Output<string | undefined>;+{{% md %}} + +A message to include with a re-notification. Supports the '@username' +notification allowed elsewhere. + +{{% /md %}} +
public evaluationDelay: pulumi.Output<number>;+{{% md %}} +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public includeTags: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether notifications from this monitor will automatically insert its + +{{% /md %}} +
public locked: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether changes to to this monitor should be restricted to the creator or admins. Defaults to False. + +{{% /md %}} +
public message: pulumi.Output<string>;+{{% md %}} + +A message to include with notifications for this monitor. +Email notifications can be sent to specific users by using the same '@username' notation as events. + +{{% /md %}} +
public name: pulumi.Output<string>;+{{% md %}} + +Name of Datadog monitor + +{{% /md %}} +
public newHostDelay: pulumi.Output<number | undefined>;+{{% md %}} + +Time (in seconds) to allow a host to boot and +applications to fully start before starting the evaluation of monitor +results. Should be a non negative integer. Defaults to 300. +* `evaluation_delay` (Optional, only applies to metric alert) Time (in seconds) to delay evaluation, as a non-negative integer. +For example, if the value is set to 300 (5min), the timeframe is set to last_5m and the time is 7:00, +the monitor will evaluate data from 6:50 to 6:55. This is useful for AWS CloudWatch and other backfilled +metrics to ensure the monitor will always have data during evaluation. + +{{% /md %}} +
public noDataTimeframe: pulumi.Output<number | undefined>;+{{% md %}} + +The number of minutes before a monitor will notify when data stops reporting. Must be at +least 2x the monitor timeframe for metric alerts or 2 minutes for service checks. Default: 2x timeframe for +metric alerts, 2 minutes for service checks. + +{{% /md %}} +
public notifyAudit: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether tagged users will be notified on changes to this monitor. +Defaults to false. + +{{% /md %}} +
public notifyNoData: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether this monitor will notify when data stops reporting. Defaults +to false. + +{{% /md %}} +
public query: pulumi.Output<string>;+{{% md %}} + +The monitor query to notify on. Note this is not the same query you see in the UI and +the syntax is different depending on the monitor `type`, please see the [API Reference](https://docs.datadoghq.com/api/?lang=python#create-a-monitor) for details. **Warning:** `terraform plan` won't perform any validation of the query contents. + +{{% /md %}} +
public renotifyInterval: pulumi.Output<number | undefined>;+{{% md %}} + +The number of minutes after the last notification before a monitor will re-notify +on the current status. It will only re-notify if it's not resolved. + +{{% /md %}} +
public requireFullWindow: pulumi.Output<boolean | undefined>;+{{% md %}} + +A boolean indicating whether this monitor needs a full window of data before it's evaluated. +We highly recommend you set this to False for sparse metrics, otherwise some evaluations will be skipped. +Default: True for "on average", "at all times" and "in total" aggregation. False otherwise. + +{{% /md %}} +
public silenced: pulumi.Output<{[key: string]: number} | undefined>;+{{% md %}} + +Each scope will be muted until the given POSIX timestamp or forever if the value is 0. +To mute the alert completely: + +{{% /md %}} +
public tags: pulumi.Output<string[] | undefined>;+{{% md %}} + +A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API + +{{% /md %}} +
public thresholdWindows: pulumi.Output<{ + recoveryWindow: undefined | string; + triggerWindow: undefined | string; +} | undefined>;+{{% md %}} + +A mapping containing `recovery_window` and `trigger_window` values, e.g. `last_15m`. Can only be used for anomaly monitors. +* `recovery_window` describes how long an anomalous metric must be normal before the alert recovers. + +{{% /md %}} +
public thresholds: pulumi.Output<{ + critical: undefined | number; + criticalRecovery: undefined | number; + ok: undefined | number; + unknown: undefined | number; + warning: undefined | number; + warningRecovery: undefined | number; +} | undefined>;+{{% md %}} + +* Metric alerts: +A dictionary of thresholds by threshold type. Currently we have four threshold types for metric alerts: critical, critical recovery, warning, and warning recovery. Critical is defined in the query, but can also be specified in this option. Warning and recovery thresholds can only be specified using the thresholds option. +Example usage: +``` +thresholds = { +critical = 90 +critical_recovery = 85 +warning = 80 +warning_recovery = 75 +} +``` +**Warning:** the `critical` threshold value must match the one contained in the `query` argument. The `threshold` from the previous example is valid along with a query like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 90` but +along with something like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 95` would make the Datadog API return a HTTP error 400, complaining "The value provided for parameter 'query' is invalid". +* Service checks: +A dictionary of thresholds by status. Because service checks can have multiple thresholds, we don't define them directly in the query. +Default values: +``` +thresholds = { +ok = 1 +critical = 1 +warning = 1 +unknown = 1 +} +``` + +{{% /md %}} +
public timeoutH: pulumi.Output<number | undefined>;+{{% md %}} + +The number of hours of the monitor not reporting data before it will automatically resolve +from a triggered state. Defaults to false. + +{{% /md %}} +
public type: pulumi.Output<string>;+{{% md %}} + +The type of the monitor, chosen from: +* `metric alert` +* `service check` +* `event alert` +* `query alert` +* `composite` +* `log alert` + +{{% /md %}} +
extends ProviderResource
+{{% md %}}
+
+The provider type for the datadog package. By default, resources use package-wide configuration
+settings, however an explicit `Provider` instance may be created and passed during resource
+construction to achieve fine-grained programmatic control over provider settings. See the
+[documentation](https://pulumi.io/reference/programming-model.html#providers) for more information.
+
+{{% /md %}}
+new Provider(name: string, args?: ProviderArgs, opts?: pulumi.ResourceOptions)+ + +Create a Provider resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Provider. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog screenboard resource. This can be used to create and manage Datadog screenboards. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog screenboard +const acceptanceTest = new datadog.ScreenBoard("acceptance_test", { + readOnly: true, + templateVariables: [ + { + default: "*", + name: "varname 1", + prefix: "pod_name", + }, + { + default: "autoscaling", + name: "varname 2", + prefix: "service_name", + }, + ], + title: "Test Screenboard", + widgets: [ + { + color: "#ffc0cb", + fontSize: "36", + text: "test text", + textAlign: "right", + type: "free_text", + x: 5, + y: 5, + }, + { + legend: true, + legendSize: "16", + tileDeves: [{ + events: [{ + q: "test event", + }], + markers: [{ + label: "test marker", + type: "error dashed", + value: "y < 6", + }], + requests: [{ + q: "avg:system.cpu.user{*}", + style: { + palette: "purple", + type: "dashed", + width: "thin", + }, + type: "line", + }], + viz: "timeseries", + }], + time: { + live_span: "1d", + }, + title: "graph title terraform", + titleAlign: "right", + titleSize: 16, + type: "timeseries", + x: 25, + y: 5, + }, + { + legend: true, + legendSize: "16", + tileDeves: [{ + autoscale: false, + customUnit: "%", + precision: "6", + requests: [{ + aggregator: "max", + conditionalFormats: [ + { + comparator: ">", + palette: "white_on_red", + value: "1", + }, + { + comparator: ">=", + palette: "white_on_yellow", + value: "2", + }, + ], + q: "avg:system.cpu.user{*}", + style: { + palette: "purple", + type: "dashed", + width: "thin", + }, + type: "line", + }], + textAlign: "right", + viz: "query_value", + }], + title: "query value title terraform", + titleAlign: "center", + titleSize: 20, + type: "query_value", + x: 45, + y: 25, + }, + { + legend: true, + legendSize: "auto", + tileDeves: [{ + requests: [{ + conditionalFormats: [{ + comparator: ">", + palette: "white_on_green", + value: "4", + }], + q: "top(avg:system.load.1{*} by {host}, 10, 'mean', 'desc')", + style: { + palette: "purple", + type: "dashed", + width: "thin", + }, + }], + viz: "toplist", + }], + time: { + live_span: "1d", + }, + title: "toplist title terraform", + type: "toplist", + x: 65, + y: 5, + }, + { + tileDeves: [{ + requests: [{ + changeType: "relative", + compareTo: "week_before", + extraCol: "", + increaseGood: false, + orderBy: "present", + orderDir: "asc", + q: "min:system.load.1{*} by {host}", + }], + viz: "change", + }], + title: "change title terraform", + type: "change", + x: 85, + y: 5, + }, + { + query: "status:error", + time: { + live_span: "1d", + }, + title: "event_timeline title terraform", + type: "event_timeline", + x: 105, + y: 5, + }, + { + eventSize: "l", + query: "*", + time: { + live_span: "4h", + }, + title: "event_stream title terraform", + type: "event_stream", + x: 115, + y: 5, + }, + { + margin: "large", + sizing: "fit", + title: "image title terraform", + type: "image", + url: "https://datadog-prod.imgix.net/img/dd_logo_70x75.png", + x: 145, + y: 5, + }, + { + bgcolor: "pink", + fontSize: "36", + html: "test note", + textAlign: "right", + tick: true, + tickEdge: "bottom", + tickPos: "50%", + type: "note", + x: 165, + y: 5, + }, + { + alertId: 123456, + time: { + live_span: "15m", + }, + title: "alert graph title terraform", + type: "alert_graph", + vizType: "toplist", + x: 185, + y: 5, + }, + { + alertId: 123456, + precision: "*", + textAlign: "right", + textSize: "fill_height", + title: "alert value title terraform", + type: "alert_value", + unit: "b", + x: 205, + y: 5, + }, + { + type: "iframe", + url: "https://www.datadoghq.org", + x: 225, + y: 5, + }, + { + check: "aws.ecs.agent_connected", + group: "cluster:test", + grouping: "check", + tags: ["*"], + time: { + live_span: "30m", + }, + title: "test title", + titleAlign: "left", + type: "check_status", + x: 245, + y: 5, + }, + { + env: "testEnv", + layoutVersion: "three_column", + mustShowBreakdown: true, + mustShowDistribution: true, + mustShowErrors: true, + mustShowHits: true, + mustShowLatency: true, + mustShowResourceList: true, + serviceName: "", + serviceService: "", + sizeVersion: "large", + time: { + live_span: "30m", + }, + type: "trace_service", + x: 265, + y: 5, + }, + { + query: "avg:system.load.1{*} by {host}", + tileDeves: [{ + groups: ["pod_name"], + noGroupHosts: false, + noMetricHosts: false, + nodeType: "container", + requests: [{ + q: "max:process.stat.container.io.wbps{datacenter:test} by {host}", + type: "fill", + }], + scopes: ["datacenter:test"], + style: { + fill_max: 300, + fill_min: 20, + palette: "hostmap_blues", + palette_flip: true, + }, + viz: "hostmap", + }], + type: "hostmap", + x: 285, + y: 5, + }, + { + colorPreference: "background", + displayFormat: "countsAndList", + hideZeroCounts: true, + manageStatusShowTitle: false, + manageStatusTitleAlign: "right", + manageStatusTitleSize: "20", + manageStatusTitleText: "test title", + params: { + count: 50, + sort: "status,asc", + start: 0, + text: "status:alert", + }, + type: "manage_status", + x: 305, + y: 5, + }, + { + columns: "[\"column1\",\"column2\",\"column3\"]", + logset: "1234", + query: "source:kubernetes", + time: { + live_span: "1h", + }, + type: "log_stream", + x: 325, + y: 5, + }, + { + tileDeves: [{ + requests: [{ + limit: 200, + metric: "process.stat.cpu.total_pct", + queryType: "process", + style: { + palette: "dog_classic_area", + }, + tagFilters: [], + textFilter: "", + }], + viz: "process", + }], + type: "process", + x: 365, + y: 5, + }, + ], +}); +``` + +{{% /md %}} +
new ScreenBoard(name: string, args: ScreenBoardArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a ScreenBoard resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ScreenBoardState, opts?: pulumi.CustomResourceOptions): ScreenBoard+ + +Get an existing ScreenBoard resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of ScreenBoard. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public height: pulumi.Output<string | undefined>;+{{% md %}} + +Height of the screenboard + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public readOnly: pulumi.Output<boolean | undefined>;+{{% md %}} +{{% /md %}} +
public shared: pulumi.Output<boolean | undefined>;+{{% md %}} + +Whether the screenboard is shared or not + +{{% /md %}} +
public templateVariables: pulumi.Output<{ + default: undefined | string; + name: string; + prefix: undefined | string; +}[] | undefined>;+{{% md %}} + +A list of template variables for using Dashboard templating. + +{{% /md %}} +
public title: pulumi.Output<string>;+{{% md %}} + +Name of the screenboard + +{{% /md %}} +
urn: Output<URN>;+{{% md %}} + +urn is the stable logical URN used to distinctly address a resource, both before and after +deployments. + +{{% /md %}} +
public widgets: pulumi.Output<{ + alertId: undefined | number; + autoRefresh: undefined | false | true; + bgcolor: undefined | string; + check: undefined | string; + color: undefined | string; + colorPreference: undefined | string; + columns: undefined | string; + displayFormat: undefined | string; + env: undefined | string; + eventSize: undefined | string; + fontSize: undefined | string; + group: undefined | string; + groupBies: string[]; + grouping: undefined | string; + height: undefined | number; + hideZeroCounts: undefined | false | true; + html: undefined | string; + layoutVersion: undefined | string; + legend: undefined | false | true; + legendSize: undefined | string; + logset: undefined | string; + manageStatusShowTitle: undefined | false | true; + manageStatusTitleAlign: undefined | string; + manageStatusTitleSize: undefined | string; + manageStatusTitleText: undefined | string; + margin: undefined | string; + monitor: undefined | {[key: string]: number}; + mustShowBreakdown: undefined | false | true; + mustShowDistribution: undefined | false | true; + mustShowErrors: undefined | false | true; + mustShowHits: undefined | false | true; + mustShowLatency: undefined | false | true; + mustShowResourceList: undefined | false | true; + params: undefined | {[key: string]: string}; + precision: undefined | string; + query: undefined | string; + rules: { + color: undefined | string; + threshold: undefined | number; + timeframe: undefined | string; + }[]; + serviceName: undefined | string; + serviceService: undefined | string; + sizeVersion: undefined | string; + sizing: undefined | string; + tags: string[]; + text: undefined | string; + textAlign: undefined | string; + textSize: undefined | string; + tick: undefined | false | true; + tickEdge: undefined | string; + tickPos: undefined | string; + tileDeves: { + autoscale: undefined | false | true; + customUnit: undefined | string; + events: { + q: string; + }[]; + groups: string[]; + markers: { + label: undefined | string; + type: string; + value: string; + }[]; + noGroupHosts: undefined | false | true; + noMetricHosts: undefined | false | true; + nodeType: undefined | string; + precision: undefined | string; + requests: { + aggregator: undefined | string; + changeType: undefined | string; + compareTo: undefined | string; + conditionalFormats: { + color: undefined | string; + comparator: string; + invert: undefined | false | true; + palette: undefined | string; + value: undefined | string; + }[]; + extraCol: undefined | string; + increaseGood: undefined | false | true; + limit: undefined | number; + metric: undefined | string; + orderBy: undefined | string; + orderDir: undefined | string; + q: undefined | string; + queryType: undefined | string; + style: undefined | {[key: string]: any}; + tagFilters: string[]; + textFilter: undefined | string; + type: undefined | string; + }[]; + scopes: string[]; + style: undefined | {[key: string]: any}; + textAlign: undefined | string; + viz: string; + }[]; + time: undefined | {[key: string]: string}; + timeframes: string[]; + title: undefined | string; + titleAlign: undefined | string; + titleSize: undefined | number; + type: string; + unit: undefined | string; + url: undefined | string; + vizType: undefined | string; + width: undefined | number; + x: number; + y: number; +}[]>;+{{% md %}} + +A list of widget definitions. + +{{% /md %}} +
public width: pulumi.Output<string | undefined>;+{{% md %}} + +Width of the screenboard + +{{% /md %}} +
extends CustomResource+
new SyntheticsTest(name: string, args: SyntheticsTestArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a SyntheticsTest resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: SyntheticsTestState, opts?: pulumi.CustomResourceOptions): SyntheticsTest+ + +Get an existing SyntheticsTest resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of SyntheticsTest. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public assertions: pulumi.Output<{[key: string]: any}[] | undefined>;+{{% md %}} +{{% /md %}} +
public deviceIds: pulumi.Output<string[] | undefined>;+{{% md %}} +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public locations: pulumi.Output<string[]>;+{{% md %}} +{{% /md %}} +
public message: pulumi.Output<string | undefined>;+{{% md %}} +{{% /md %}} +
public name: pulumi.Output<string>;+{{% md %}} +{{% /md %}} +
public options: pulumi.Output<{ + followRedirects: undefined | false | true; + minFailureDuration: undefined | number; + minLocationFailed: undefined | number; + tickEvery: number; +} | undefined>;+{{% md %}} +{{% /md %}} +
public request: pulumi.Output<{ + body: undefined | string; + method: string; + timeout: undefined | number; + url: string; +}>;+{{% md %}} +{{% /md %}} +
public requestHeaders: pulumi.Output<{[key: string]: any} | undefined>;+{{% md %}} +{{% /md %}} +
public status: pulumi.Output<string>;+{{% md %}} +{{% /md %}} +
public tags: pulumi.Output<string[]>;+{{% md %}} +{{% /md %}} +
public type: pulumi.Output<string>;+{{% md %}} +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog timeboard resource. This can be used to create and manage Datadog timeboards. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog timeboard +const redis = new datadog.TimeBoard("redis", { + description: "created using the Datadog provider in Terraform", + graphs: [ + { + requests: [{ + q: "avg:redis.info.latency_ms{$host}", + type: "bars", + }], + title: "Redis latency (ms)", + viz: "timeseries", + }, + { + requests: [ + { + q: "avg:redis.mem.used{$host} - avg:redis.mem.lua{$host}, avg:redis.mem.lua{$host}", + stacked: true, + }, + { + q: "avg:redis.mem.rss{$host}", + style: { + palette: "warm", + }, + }, + ], + title: "Redis memory usage", + viz: "timeseries", + }, + { + requests: [{ + q: "top(avg:docker.cpu.system{*} by {container_name}, 10, 'mean', 'desc')", + }], + title: "Top System CPU by Docker container", + viz: "toplist", + }, + ], + readOnly: true, + templateVariables: [{ + name: "host", + prefix: "host", + }], + title: "Redis Timeboard (created via Terraform)", +}); +``` + +{{% /md %}} +
new TimeBoard(name: string, args: TimeBoardArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a TimeBoard resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: TimeBoardState, opts?: pulumi.CustomResourceOptions): TimeBoard+ + +Get an existing TimeBoard resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of TimeBoard. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public description: pulumi.Output<string>;+{{% md %}} + +A description of the dashboard's content. + +{{% /md %}} +
public graphs: pulumi.Output<{ + autoscale: undefined | false | true; + customUnit: undefined | string; + events: string[]; + groups: string[]; + includeNoMetricHosts: undefined | false | true; + includeUngroupedHosts: undefined | false | true; + markers: { + label: undefined | string; + type: string; + value: string; + }[]; + nodeType: undefined | string; + precision: undefined | string; + requests: { + aggregator: undefined | string; + changeType: undefined | string; + compareTo: undefined | string; + conditionalFormats: { + comparator: string; + customBgColor: undefined | string; + customFgColor: undefined | string; + palette: undefined | string; + value: undefined | string; + }[]; + extraCol: undefined | string; + increaseGood: undefined | false | true; + orderBy: undefined | string; + orderDirection: undefined | string; + q: string; + stacked: undefined | false | true; + style: undefined | {[key: string]: any}; + type: undefined | string; + }[]; + scopes: string[]; + style: undefined | {[key: string]: any}; + textAlign: undefined | string; + title: string; + viz: string; + yaxis: undefined | {[key: string]: any}; +}[]>;+{{% md %}} + +Nested block describing a graph definition. The structure of this block is described below. Multiple graph blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public readOnly: pulumi.Output<boolean | undefined>;+{{% md %}} + +The read-only status of the timeboard. Default is false. + +{{% /md %}} +
public templateVariables: pulumi.Output<{ + default: undefined | string; + name: string; + prefix: undefined | string; +}[] | undefined>;+{{% md %}} + +Nested block describing a template variable. The structure of this block is described below. Multiple template_variable blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
public title: pulumi.Output<string>;+{{% md %}} + +The name of the dashboard. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog user resource. This can be used to create and manage Datadog users. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog user +const foo = new datadog.User("foo", { + email: "new@example.com", + handle: "new@example.com", + name: "New User", +}); +``` + +{{% /md %}} +
new User(name: string, args: UserArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a User resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: UserState, opts?: pulumi.CustomResourceOptions): User+ + +Get an existing User resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of User. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public accessRole: pulumi.Output<string | undefined>;+{{% md %}} + +Role description for user. Can be `st` (standard user), `adm` (admin user) or `ro` (read-only user). Default is `st`. + +{{% /md %}} +
public disabled: pulumi.Output<boolean | undefined>;+{{% md %}} + +Whether the user is disabled + +{{% /md %}} +
public email: pulumi.Output<string>;+{{% md %}} + +Email address for user + +{{% /md %}} +
public handle: pulumi.Output<string>;+{{% md %}} + +The user handle, must be a valid email. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public isAdmin: pulumi.Output<boolean | undefined>;+{{% md %}} + +(Optional) Whether the user is an administrator. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
public name: pulumi.Output<string>;+{{% md %}} + +Name for user + +{{% /md %}} +
public role: pulumi.Output<string | undefined>;+{{% md %}} + +Role description for user. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
urn: Output<URN>;+{{% md %}} + +urn is the stable logical URN used to distinctly address a resource, both before and after +deployments. + +{{% /md %}} +
public verified: pulumi.Output<boolean>;+{{% md %}} + +Returns true if Datadog user is verified + +{{% /md %}} +
getVersion(): string
+
+{{% /md %}}
+active?: pulumi.Input<boolean>;+{{% md %}} + +A flag indicating if the downtime is active now. + +{{% /md %}} +
disabled?: pulumi.Input<boolean>;+{{% md %}} + +A flag indicating if the downtime was disabled. + +{{% /md %}} +
end?: pulumi.Input<number>;+{{% md %}} + +POSIX timestamp to end the downtime. + +{{% /md %}} +
endDate?: pulumi.Input<string>;+{{% md %}} + +String representing date and time to end the downtime in RFC3339 format. + +{{% /md %}} +
message?: pulumi.Input<string>;+{{% md %}} + +A message to include with notifications for this downtime. + +{{% /md %}} +
monitorId?: pulumi.Input<number>;+{{% md %}} + +Reference to which monitor this downtime is applied. When scheduling downtime for a given monitor, datadog changes `silenced` property of the monitor to match the `end` POSIX timestamp. + +{{% /md %}} +
monitorTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
recurrence?: pulumi.Input<{ + period: pulumi.Input<number>; + type: pulumi.Input<string>; + untilDate: pulumi.Input<number>; + untilOccurrences: pulumi.Input<number>; + weekDays: pulumi.Input<pulumi.Input<string>[]>; +}>;+{{% md %}} + +A dictionary to configure the downtime to be recurring. + +{{% /md %}} +
scopes: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +A list of items to apply the downtime to, e.g. host:X + +{{% /md %}} +
start?: pulumi.Input<number>;+{{% md %}} + +POSIX timestamp to start the downtime. + +{{% /md %}} +
startDate?: pulumi.Input<string>;+{{% md %}} + +String representing date and time to start the downtime in RFC3339 format. + +{{% /md %}} +
active?: pulumi.Input<boolean>;+{{% md %}} + +A flag indicating if the downtime is active now. + +{{% /md %}} +
disabled?: pulumi.Input<boolean>;+{{% md %}} + +A flag indicating if the downtime was disabled. + +{{% /md %}} +
end?: pulumi.Input<number>;+{{% md %}} + +POSIX timestamp to end the downtime. + +{{% /md %}} +
endDate?: pulumi.Input<string>;+{{% md %}} + +String representing date and time to end the downtime in RFC3339 format. + +{{% /md %}} +
message?: pulumi.Input<string>;+{{% md %}} + +A message to include with notifications for this downtime. + +{{% /md %}} +
monitorId?: pulumi.Input<number>;+{{% md %}} + +Reference to which monitor this downtime is applied. When scheduling downtime for a given monitor, datadog changes `silenced` property of the monitor to match the `end` POSIX timestamp. + +{{% /md %}} +
monitorTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
recurrence?: pulumi.Input<{ + period: pulumi.Input<number>; + type: pulumi.Input<string>; + untilDate: pulumi.Input<number>; + untilOccurrences: pulumi.Input<number>; + weekDays: pulumi.Input<pulumi.Input<string>[]>; +}>;+{{% md %}} + +A dictionary to configure the downtime to be recurring. + +{{% /md %}} +
scopes?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +A list of items to apply the downtime to, e.g. host:X + +{{% /md %}} +
start?: pulumi.Input<number>;+{{% md %}} + +POSIX timestamp to start the downtime. + +{{% /md %}} +
startDate?: pulumi.Input<string>;+{{% md %}} + +String representing date and time to start the downtime in RFC3339 format. + +{{% /md %}} +
description?: pulumi.Input<string>;+{{% md %}} + +A description of the metric. + +{{% /md %}} +
metric: pulumi.Input<string>;+{{% md %}} + +The name of the metric. + +{{% /md %}} +
perUnit?: pulumi.Input<string>;+{{% md %}} + +'Per' unit of the metric such as 'second' in 'bytes per second'. + +{{% /md %}} +
shortName?: pulumi.Input<string>;+{{% md %}} + +A short name of the metric. + +{{% /md %}} +
statsdInterval?: pulumi.Input<number>;+{{% md %}} + +If applicable, stasd flush interval in seconds for the metric. + +{{% /md %}} +
type?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
unit?: pulumi.Input<string>;+{{% md %}} + +Primary unit of the metric such as 'byte' or 'operation'. + +{{% /md %}} +
description?: pulumi.Input<string>;+{{% md %}} + +A description of the metric. + +{{% /md %}} +
metric?: pulumi.Input<string>;+{{% md %}} + +The name of the metric. + +{{% /md %}} +
perUnit?: pulumi.Input<string>;+{{% md %}} + +'Per' unit of the metric such as 'second' in 'bytes per second'. + +{{% /md %}} +
shortName?: pulumi.Input<string>;+{{% md %}} + +A short name of the metric. + +{{% /md %}} +
statsdInterval?: pulumi.Input<number>;+{{% md %}} + +If applicable, stasd flush interval in seconds for the metric. + +{{% /md %}} +
type?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
unit?: pulumi.Input<string>;+{{% md %}} + +Primary unit of the metric such as 'byte' or 'operation'. + +{{% /md %}} +
enableLogsSample?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether or not to include a list of log values which triggered the alert. Defaults to false. This is only used by log monitors. +triggering tags into the title. Defaults to true. + +{{% /md %}} +
escalationMessage?: pulumi.Input<string>;+{{% md %}} + +A message to include with a re-notification. Supports the '@username' +notification allowed elsewhere. + +{{% /md %}} +
evaluationDelay?: pulumi.Input<number>;+{{% md %}} +{{% /md %}} +
includeTags?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether notifications from this monitor will automatically insert its + +{{% /md %}} +
locked?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether changes to to this monitor should be restricted to the creator or admins. Defaults to False. + +{{% /md %}} +
message: pulumi.Input<string>;+{{% md %}} + +A message to include with notifications for this monitor. +Email notifications can be sent to specific users by using the same '@username' notation as events. + +{{% /md %}} +
name: pulumi.Input<string>;+{{% md %}} + +Name of Datadog monitor + +{{% /md %}} +
newHostDelay?: pulumi.Input<number>;+{{% md %}} + +Time (in seconds) to allow a host to boot and +applications to fully start before starting the evaluation of monitor +results. Should be a non negative integer. Defaults to 300. +* `evaluation_delay` (Optional, only applies to metric alert) Time (in seconds) to delay evaluation, as a non-negative integer. +For example, if the value is set to 300 (5min), the timeframe is set to last_5m and the time is 7:00, +the monitor will evaluate data from 6:50 to 6:55. This is useful for AWS CloudWatch and other backfilled +metrics to ensure the monitor will always have data during evaluation. + +{{% /md %}} +
noDataTimeframe?: pulumi.Input<number>;+{{% md %}} + +The number of minutes before a monitor will notify when data stops reporting. Must be at +least 2x the monitor timeframe for metric alerts or 2 minutes for service checks. Default: 2x timeframe for +metric alerts, 2 minutes for service checks. + +{{% /md %}} +
notifyAudit?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether tagged users will be notified on changes to this monitor. +Defaults to false. + +{{% /md %}} +
notifyNoData?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether this monitor will notify when data stops reporting. Defaults +to false. + +{{% /md %}} +
query: pulumi.Input<string>;+{{% md %}} + +The monitor query to notify on. Note this is not the same query you see in the UI and +the syntax is different depending on the monitor `type`, please see the [API Reference](https://docs.datadoghq.com/api/?lang=python#create-a-monitor) for details. **Warning:** `terraform plan` won't perform any validation of the query contents. + +{{% /md %}} +
renotifyInterval?: pulumi.Input<number>;+{{% md %}} + +The number of minutes after the last notification before a monitor will re-notify +on the current status. It will only re-notify if it's not resolved. + +{{% /md %}} +
requireFullWindow?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether this monitor needs a full window of data before it's evaluated. +We highly recommend you set this to False for sparse metrics, otherwise some evaluations will be skipped. +Default: True for "on average", "at all times" and "in total" aggregation. False otherwise. + +{{% /md %}} +
silenced?: pulumi.Input<{[key: string]: pulumi.Input<number>}>;+{{% md %}} + +Each scope will be muted until the given POSIX timestamp or forever if the value is 0. +To mute the alert completely: + +{{% /md %}} +
tags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API + +{{% /md %}} +
thresholdWindows?: pulumi.Input<{ + recoveryWindow: pulumi.Input<string>; + triggerWindow: pulumi.Input<string>; +}>;+{{% md %}} + +A mapping containing `recovery_window` and `trigger_window` values, e.g. `last_15m`. Can only be used for anomaly monitors. +* `recovery_window` describes how long an anomalous metric must be normal before the alert recovers. + +{{% /md %}} +
thresholds?: pulumi.Input<{ + critical: pulumi.Input<number>; + criticalRecovery: pulumi.Input<number>; + ok: pulumi.Input<number>; + unknown: pulumi.Input<number>; + warning: pulumi.Input<number>; + warningRecovery: pulumi.Input<number>; +}>;+{{% md %}} + +* Metric alerts: +A dictionary of thresholds by threshold type. Currently we have four threshold types for metric alerts: critical, critical recovery, warning, and warning recovery. Critical is defined in the query, but can also be specified in this option. Warning and recovery thresholds can only be specified using the thresholds option. +Example usage: +``` +thresholds = { +critical = 90 +critical_recovery = 85 +warning = 80 +warning_recovery = 75 +} +``` +**Warning:** the `critical` threshold value must match the one contained in the `query` argument. The `threshold` from the previous example is valid along with a query like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 90` but +along with something like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 95` would make the Datadog API return a HTTP error 400, complaining "The value provided for parameter 'query' is invalid". +* Service checks: +A dictionary of thresholds by status. Because service checks can have multiple thresholds, we don't define them directly in the query. +Default values: +``` +thresholds = { +ok = 1 +critical = 1 +warning = 1 +unknown = 1 +} +``` + +{{% /md %}} +
timeoutH?: pulumi.Input<number>;+{{% md %}} + +The number of hours of the monitor not reporting data before it will automatically resolve +from a triggered state. Defaults to false. + +{{% /md %}} +
type: pulumi.Input<string>;+{{% md %}} + +The type of the monitor, chosen from: +* `metric alert` +* `service check` +* `event alert` +* `query alert` +* `composite` +* `log alert` + +{{% /md %}} +
enableLogsSample?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether or not to include a list of log values which triggered the alert. Defaults to false. This is only used by log monitors. +triggering tags into the title. Defaults to true. + +{{% /md %}} +
escalationMessage?: pulumi.Input<string>;+{{% md %}} + +A message to include with a re-notification. Supports the '@username' +notification allowed elsewhere. + +{{% /md %}} +
evaluationDelay?: pulumi.Input<number>;+{{% md %}} +{{% /md %}} +
includeTags?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether notifications from this monitor will automatically insert its + +{{% /md %}} +
locked?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether changes to to this monitor should be restricted to the creator or admins. Defaults to False. + +{{% /md %}} +
message?: pulumi.Input<string>;+{{% md %}} + +A message to include with notifications for this monitor. +Email notifications can be sent to specific users by using the same '@username' notation as events. + +{{% /md %}} +
name?: pulumi.Input<string>;+{{% md %}} + +Name of Datadog monitor + +{{% /md %}} +
newHostDelay?: pulumi.Input<number>;+{{% md %}} + +Time (in seconds) to allow a host to boot and +applications to fully start before starting the evaluation of monitor +results. Should be a non negative integer. Defaults to 300. +* `evaluation_delay` (Optional, only applies to metric alert) Time (in seconds) to delay evaluation, as a non-negative integer. +For example, if the value is set to 300 (5min), the timeframe is set to last_5m and the time is 7:00, +the monitor will evaluate data from 6:50 to 6:55. This is useful for AWS CloudWatch and other backfilled +metrics to ensure the monitor will always have data during evaluation. + +{{% /md %}} +
noDataTimeframe?: pulumi.Input<number>;+{{% md %}} + +The number of minutes before a monitor will notify when data stops reporting. Must be at +least 2x the monitor timeframe for metric alerts or 2 minutes for service checks. Default: 2x timeframe for +metric alerts, 2 minutes for service checks. + +{{% /md %}} +
notifyAudit?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether tagged users will be notified on changes to this monitor. +Defaults to false. + +{{% /md %}} +
notifyNoData?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether this monitor will notify when data stops reporting. Defaults +to false. + +{{% /md %}} +
query?: pulumi.Input<string>;+{{% md %}} + +The monitor query to notify on. Note this is not the same query you see in the UI and +the syntax is different depending on the monitor `type`, please see the [API Reference](https://docs.datadoghq.com/api/?lang=python#create-a-monitor) for details. **Warning:** `terraform plan` won't perform any validation of the query contents. + +{{% /md %}} +
renotifyInterval?: pulumi.Input<number>;+{{% md %}} + +The number of minutes after the last notification before a monitor will re-notify +on the current status. It will only re-notify if it's not resolved. + +{{% /md %}} +
requireFullWindow?: pulumi.Input<boolean>;+{{% md %}} + +A boolean indicating whether this monitor needs a full window of data before it's evaluated. +We highly recommend you set this to False for sparse metrics, otherwise some evaluations will be skipped. +Default: True for "on average", "at all times" and "in total" aggregation. False otherwise. + +{{% /md %}} +
silenced?: pulumi.Input<{[key: string]: pulumi.Input<number>}>;+{{% md %}} + +Each scope will be muted until the given POSIX timestamp or forever if the value is 0. +To mute the alert completely: + +{{% /md %}} +
tags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API + +{{% /md %}} +
thresholdWindows?: pulumi.Input<{ + recoveryWindow: pulumi.Input<string>; + triggerWindow: pulumi.Input<string>; +}>;+{{% md %}} + +A mapping containing `recovery_window` and `trigger_window` values, e.g. `last_15m`. Can only be used for anomaly monitors. +* `recovery_window` describes how long an anomalous metric must be normal before the alert recovers. + +{{% /md %}} +
thresholds?: pulumi.Input<{ + critical: pulumi.Input<number>; + criticalRecovery: pulumi.Input<number>; + ok: pulumi.Input<number>; + unknown: pulumi.Input<number>; + warning: pulumi.Input<number>; + warningRecovery: pulumi.Input<number>; +}>;+{{% md %}} + +* Metric alerts: +A dictionary of thresholds by threshold type. Currently we have four threshold types for metric alerts: critical, critical recovery, warning, and warning recovery. Critical is defined in the query, but can also be specified in this option. Warning and recovery thresholds can only be specified using the thresholds option. +Example usage: +``` +thresholds = { +critical = 90 +critical_recovery = 85 +warning = 80 +warning_recovery = 75 +} +``` +**Warning:** the `critical` threshold value must match the one contained in the `query` argument. The `threshold` from the previous example is valid along with a query like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 90` but +along with something like `avg(last_1h):avg:system.disk.in_use{role:sqlserver} by {host} > 95` would make the Datadog API return a HTTP error 400, complaining "The value provided for parameter 'query' is invalid". +* Service checks: +A dictionary of thresholds by status. Because service checks can have multiple thresholds, we don't define them directly in the query. +Default values: +``` +thresholds = { +ok = 1 +critical = 1 +warning = 1 +unknown = 1 +} +``` + +{{% /md %}} +
timeoutH?: pulumi.Input<number>;+{{% md %}} + +The number of hours of the monitor not reporting data before it will automatically resolve +from a triggered state. Defaults to false. + +{{% /md %}} +
type?: pulumi.Input<string>;+{{% md %}} + +The type of the monitor, chosen from: +* `metric alert` +* `service check` +* `event alert` +* `query alert` +* `composite` +* `log alert` + +{{% /md %}} +
apiKey?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
apiUrl?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
appKey?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
height?: pulumi.Input<string>;+{{% md %}} + +Height of the screenboard + +{{% /md %}} +
readOnly?: pulumi.Input<boolean>;+{{% md %}} +{{% /md %}} +
shared?: pulumi.Input<boolean>;+{{% md %}} + +Whether the screenboard is shared or not + +{{% /md %}} +
templateVariables?: pulumi.Input<pulumi.Input<{ + default: pulumi.Input<string>; + name: pulumi.Input<string>; + prefix: pulumi.Input<string>; +}>[]>;+{{% md %}} + +A list of template variables for using Dashboard templating. + +{{% /md %}} +
title: pulumi.Input<string>;+{{% md %}} + +Name of the screenboard + +{{% /md %}} +
widgets: pulumi.Input<pulumi.Input<{ + alertId: pulumi.Input<number>; + autoRefresh: pulumi.Input<boolean>; + bgcolor: pulumi.Input<string>; + check: pulumi.Input<string>; + color: pulumi.Input<string>; + colorPreference: pulumi.Input<string>; + columns: pulumi.Input<string>; + displayFormat: pulumi.Input<string>; + env: pulumi.Input<string>; + eventSize: pulumi.Input<string>; + fontSize: pulumi.Input<string>; + group: pulumi.Input<string>; + groupBies: pulumi.Input<pulumi.Input<string>[]>; + grouping: pulumi.Input<string>; + height: pulumi.Input<number>; + hideZeroCounts: pulumi.Input<boolean>; + html: pulumi.Input<string>; + layoutVersion: pulumi.Input<string>; + legend: pulumi.Input<boolean>; + legendSize: pulumi.Input<string>; + logset: pulumi.Input<string>; + manageStatusShowTitle: pulumi.Input<boolean>; + manageStatusTitleAlign: pulumi.Input<string>; + manageStatusTitleSize: pulumi.Input<string>; + manageStatusTitleText: pulumi.Input<string>; + margin: pulumi.Input<string>; + monitor: pulumi.Input<{[key: string]: pulumi.Input<number>}>; + mustShowBreakdown: pulumi.Input<boolean>; + mustShowDistribution: pulumi.Input<boolean>; + mustShowErrors: pulumi.Input<boolean>; + mustShowHits: pulumi.Input<boolean>; + mustShowLatency: pulumi.Input<boolean>; + mustShowResourceList: pulumi.Input<boolean>; + params: pulumi.Input<{[key: string]: pulumi.Input<string>}>; + precision: pulumi.Input<string>; + query: pulumi.Input<string>; + rules: pulumi.Input<pulumi.Input<{ + color: pulumi.Input<string>; + threshold: pulumi.Input<number>; + timeframe: pulumi.Input<string>; + }>[]>; + serviceName: pulumi.Input<string>; + serviceService: pulumi.Input<string>; + sizeVersion: pulumi.Input<string>; + sizing: pulumi.Input<string>; + tags: pulumi.Input<pulumi.Input<string>[]>; + text: pulumi.Input<string>; + textAlign: pulumi.Input<string>; + textSize: pulumi.Input<string>; + tick: pulumi.Input<boolean>; + tickEdge: pulumi.Input<string>; + tickPos: pulumi.Input<string>; + tileDeves: pulumi.Input<pulumi.Input<{ + autoscale: pulumi.Input<boolean>; + customUnit: pulumi.Input<string>; + events: pulumi.Input<pulumi.Input<{ + q: pulumi.Input<string>; + }>[]>; + groups: pulumi.Input<pulumi.Input<string>[]>; + markers: pulumi.Input<pulumi.Input<{ + label: pulumi.Input<string>; + type: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + noGroupHosts: pulumi.Input<boolean>; + noMetricHosts: pulumi.Input<boolean>; + nodeType: pulumi.Input<string>; + precision: pulumi.Input<string>; + requests: pulumi.Input<pulumi.Input<{ + aggregator: pulumi.Input<string>; + changeType: pulumi.Input<string>; + compareTo: pulumi.Input<string>; + conditionalFormats: pulumi.Input<pulumi.Input<{ + color: pulumi.Input<string>; + comparator: pulumi.Input<string>; + invert: pulumi.Input<boolean>; + palette: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + extraCol: pulumi.Input<string>; + increaseGood: pulumi.Input<boolean>; + limit: pulumi.Input<number>; + metric: pulumi.Input<string>; + orderBy: pulumi.Input<string>; + orderDir: pulumi.Input<string>; + q: pulumi.Input<string>; + queryType: pulumi.Input<string>; + style: pulumi.Input<{[key: string]: any}>; + tagFilters: pulumi.Input<pulumi.Input<string>[]>; + textFilter: pulumi.Input<string>; + type: pulumi.Input<string>; + }>[]>; + scopes: pulumi.Input<pulumi.Input<string>[]>; + style: pulumi.Input<{[key: string]: any}>; + textAlign: pulumi.Input<string>; + viz: pulumi.Input<string>; + }>[]>; + time: pulumi.Input<{[key: string]: pulumi.Input<string>}>; + timeframes: pulumi.Input<pulumi.Input<string>[]>; + title: pulumi.Input<string>; + titleAlign: pulumi.Input<string>; + titleSize: pulumi.Input<number>; + type: pulumi.Input<string>; + unit: pulumi.Input<string>; + url: pulumi.Input<string>; + vizType: pulumi.Input<string>; + width: pulumi.Input<number>; + x: pulumi.Input<number>; + y: pulumi.Input<number>; +}>[]>;+{{% md %}} + +A list of widget definitions. + +{{% /md %}} +
width?: pulumi.Input<string>;+{{% md %}} + +Width of the screenboard + +{{% /md %}} +
height?: pulumi.Input<string>;+{{% md %}} + +Height of the screenboard + +{{% /md %}} +
readOnly?: pulumi.Input<boolean>;+{{% md %}} +{{% /md %}} +
shared?: pulumi.Input<boolean>;+{{% md %}} + +Whether the screenboard is shared or not + +{{% /md %}} +
templateVariables?: pulumi.Input<pulumi.Input<{ + default: pulumi.Input<string>; + name: pulumi.Input<string>; + prefix: pulumi.Input<string>; +}>[]>;+{{% md %}} + +A list of template variables for using Dashboard templating. + +{{% /md %}} +
title?: pulumi.Input<string>;+{{% md %}} + +Name of the screenboard + +{{% /md %}} +
widgets?: pulumi.Input<pulumi.Input<{ + alertId: pulumi.Input<number>; + autoRefresh: pulumi.Input<boolean>; + bgcolor: pulumi.Input<string>; + check: pulumi.Input<string>; + color: pulumi.Input<string>; + colorPreference: pulumi.Input<string>; + columns: pulumi.Input<string>; + displayFormat: pulumi.Input<string>; + env: pulumi.Input<string>; + eventSize: pulumi.Input<string>; + fontSize: pulumi.Input<string>; + group: pulumi.Input<string>; + groupBies: pulumi.Input<pulumi.Input<string>[]>; + grouping: pulumi.Input<string>; + height: pulumi.Input<number>; + hideZeroCounts: pulumi.Input<boolean>; + html: pulumi.Input<string>; + layoutVersion: pulumi.Input<string>; + legend: pulumi.Input<boolean>; + legendSize: pulumi.Input<string>; + logset: pulumi.Input<string>; + manageStatusShowTitle: pulumi.Input<boolean>; + manageStatusTitleAlign: pulumi.Input<string>; + manageStatusTitleSize: pulumi.Input<string>; + manageStatusTitleText: pulumi.Input<string>; + margin: pulumi.Input<string>; + monitor: pulumi.Input<{[key: string]: pulumi.Input<number>}>; + mustShowBreakdown: pulumi.Input<boolean>; + mustShowDistribution: pulumi.Input<boolean>; + mustShowErrors: pulumi.Input<boolean>; + mustShowHits: pulumi.Input<boolean>; + mustShowLatency: pulumi.Input<boolean>; + mustShowResourceList: pulumi.Input<boolean>; + params: pulumi.Input<{[key: string]: pulumi.Input<string>}>; + precision: pulumi.Input<string>; + query: pulumi.Input<string>; + rules: pulumi.Input<pulumi.Input<{ + color: pulumi.Input<string>; + threshold: pulumi.Input<number>; + timeframe: pulumi.Input<string>; + }>[]>; + serviceName: pulumi.Input<string>; + serviceService: pulumi.Input<string>; + sizeVersion: pulumi.Input<string>; + sizing: pulumi.Input<string>; + tags: pulumi.Input<pulumi.Input<string>[]>; + text: pulumi.Input<string>; + textAlign: pulumi.Input<string>; + textSize: pulumi.Input<string>; + tick: pulumi.Input<boolean>; + tickEdge: pulumi.Input<string>; + tickPos: pulumi.Input<string>; + tileDeves: pulumi.Input<pulumi.Input<{ + autoscale: pulumi.Input<boolean>; + customUnit: pulumi.Input<string>; + events: pulumi.Input<pulumi.Input<{ + q: pulumi.Input<string>; + }>[]>; + groups: pulumi.Input<pulumi.Input<string>[]>; + markers: pulumi.Input<pulumi.Input<{ + label: pulumi.Input<string>; + type: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + noGroupHosts: pulumi.Input<boolean>; + noMetricHosts: pulumi.Input<boolean>; + nodeType: pulumi.Input<string>; + precision: pulumi.Input<string>; + requests: pulumi.Input<pulumi.Input<{ + aggregator: pulumi.Input<string>; + changeType: pulumi.Input<string>; + compareTo: pulumi.Input<string>; + conditionalFormats: pulumi.Input<pulumi.Input<{ + color: pulumi.Input<string>; + comparator: pulumi.Input<string>; + invert: pulumi.Input<boolean>; + palette: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + extraCol: pulumi.Input<string>; + increaseGood: pulumi.Input<boolean>; + limit: pulumi.Input<number>; + metric: pulumi.Input<string>; + orderBy: pulumi.Input<string>; + orderDir: pulumi.Input<string>; + q: pulumi.Input<string>; + queryType: pulumi.Input<string>; + style: pulumi.Input<{[key: string]: any}>; + tagFilters: pulumi.Input<pulumi.Input<string>[]>; + textFilter: pulumi.Input<string>; + type: pulumi.Input<string>; + }>[]>; + scopes: pulumi.Input<pulumi.Input<string>[]>; + style: pulumi.Input<{[key: string]: any}>; + textAlign: pulumi.Input<string>; + viz: pulumi.Input<string>; + }>[]>; + time: pulumi.Input<{[key: string]: pulumi.Input<string>}>; + timeframes: pulumi.Input<pulumi.Input<string>[]>; + title: pulumi.Input<string>; + titleAlign: pulumi.Input<string>; + titleSize: pulumi.Input<number>; + type: pulumi.Input<string>; + unit: pulumi.Input<string>; + url: pulumi.Input<string>; + vizType: pulumi.Input<string>; + width: pulumi.Input<number>; + x: pulumi.Input<number>; + y: pulumi.Input<number>; +}>[]>;+{{% md %}} + +A list of widget definitions. + +{{% /md %}} +
width?: pulumi.Input<string>;+{{% md %}} + +Width of the screenboard + +{{% /md %}} +
assertions?: pulumi.Input<pulumi.Input<{[key: string]: any}>[]>;+{{% md %}} +{{% /md %}} +
deviceIds?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
locations: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
message?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
name: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
options?: pulumi.Input<{ + followRedirects: pulumi.Input<boolean>; + minFailureDuration: pulumi.Input<number>; + minLocationFailed: pulumi.Input<number>; + tickEvery: pulumi.Input<number>; +}>;+{{% md %}} +{{% /md %}} +
request: pulumi.Input<{ + body: pulumi.Input<string>; + method: pulumi.Input<string>; + timeout: pulumi.Input<number>; + url: pulumi.Input<string>; +}>;+{{% md %}} +{{% /md %}} +
requestHeaders?: pulumi.Input<{[key: string]: any}>;+{{% md %}} +{{% /md %}} +
status: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
tags: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
type: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
assertions?: pulumi.Input<pulumi.Input<{[key: string]: any}>[]>;+{{% md %}} +{{% /md %}} +
deviceIds?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
locations?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
message?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
name?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
options?: pulumi.Input<{ + followRedirects: pulumi.Input<boolean>; + minFailureDuration: pulumi.Input<number>; + minLocationFailed: pulumi.Input<number>; + tickEvery: pulumi.Input<number>; +}>;+{{% md %}} +{{% /md %}} +
request?: pulumi.Input<{ + body: pulumi.Input<string>; + method: pulumi.Input<string>; + timeout: pulumi.Input<number>; + url: pulumi.Input<string>; +}>;+{{% md %}} +{{% /md %}} +
requestHeaders?: pulumi.Input<{[key: string]: any}>;+{{% md %}} +{{% /md %}} +
status?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
tags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} +{{% /md %}} +
type?: pulumi.Input<string>;+{{% md %}} +{{% /md %}} +
description: pulumi.Input<string>;+{{% md %}} + +A description of the dashboard's content. + +{{% /md %}} +
graphs: pulumi.Input<pulumi.Input<{ + autoscale: pulumi.Input<boolean>; + customUnit: pulumi.Input<string>; + events: pulumi.Input<pulumi.Input<string>[]>; + groups: pulumi.Input<pulumi.Input<string>[]>; + includeNoMetricHosts: pulumi.Input<boolean>; + includeUngroupedHosts: pulumi.Input<boolean>; + markers: pulumi.Input<pulumi.Input<{ + label: pulumi.Input<string>; + type: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + nodeType: pulumi.Input<string>; + precision: pulumi.Input<string>; + requests: pulumi.Input<pulumi.Input<{ + aggregator: pulumi.Input<string>; + changeType: pulumi.Input<string>; + compareTo: pulumi.Input<string>; + conditionalFormats: pulumi.Input<pulumi.Input<{ + comparator: pulumi.Input<string>; + customBgColor: pulumi.Input<string>; + customFgColor: pulumi.Input<string>; + palette: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + extraCol: pulumi.Input<string>; + increaseGood: pulumi.Input<boolean>; + orderBy: pulumi.Input<string>; + orderDirection: pulumi.Input<string>; + q: pulumi.Input<string>; + stacked: pulumi.Input<boolean>; + style: pulumi.Input<{[key: string]: any}>; + type: pulumi.Input<string>; + }>[]>; + scopes: pulumi.Input<pulumi.Input<string>[]>; + style: pulumi.Input<{[key: string]: any}>; + textAlign: pulumi.Input<string>; + title: pulumi.Input<string>; + viz: pulumi.Input<string>; + yaxis: pulumi.Input<{[key: string]: any}>; +}>[]>;+{{% md %}} + +Nested block describing a graph definition. The structure of this block is described below. Multiple graph blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
readOnly?: pulumi.Input<boolean>;+{{% md %}} + +The read-only status of the timeboard. Default is false. + +{{% /md %}} +
templateVariables?: pulumi.Input<pulumi.Input<{ + default: pulumi.Input<string>; + name: pulumi.Input<string>; + prefix: pulumi.Input<string>; +}>[]>;+{{% md %}} + +Nested block describing a template variable. The structure of this block is described below. Multiple template_variable blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
title: pulumi.Input<string>;+{{% md %}} + +The name of the dashboard. + +{{% /md %}} +
description?: pulumi.Input<string>;+{{% md %}} + +A description of the dashboard's content. + +{{% /md %}} +
graphs?: pulumi.Input<pulumi.Input<{ + autoscale: pulumi.Input<boolean>; + customUnit: pulumi.Input<string>; + events: pulumi.Input<pulumi.Input<string>[]>; + groups: pulumi.Input<pulumi.Input<string>[]>; + includeNoMetricHosts: pulumi.Input<boolean>; + includeUngroupedHosts: pulumi.Input<boolean>; + markers: pulumi.Input<pulumi.Input<{ + label: pulumi.Input<string>; + type: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + nodeType: pulumi.Input<string>; + precision: pulumi.Input<string>; + requests: pulumi.Input<pulumi.Input<{ + aggregator: pulumi.Input<string>; + changeType: pulumi.Input<string>; + compareTo: pulumi.Input<string>; + conditionalFormats: pulumi.Input<pulumi.Input<{ + comparator: pulumi.Input<string>; + customBgColor: pulumi.Input<string>; + customFgColor: pulumi.Input<string>; + palette: pulumi.Input<string>; + value: pulumi.Input<string>; + }>[]>; + extraCol: pulumi.Input<string>; + increaseGood: pulumi.Input<boolean>; + orderBy: pulumi.Input<string>; + orderDirection: pulumi.Input<string>; + q: pulumi.Input<string>; + stacked: pulumi.Input<boolean>; + style: pulumi.Input<{[key: string]: any}>; + type: pulumi.Input<string>; + }>[]>; + scopes: pulumi.Input<pulumi.Input<string>[]>; + style: pulumi.Input<{[key: string]: any}>; + textAlign: pulumi.Input<string>; + title: pulumi.Input<string>; + viz: pulumi.Input<string>; + yaxis: pulumi.Input<{[key: string]: any}>; +}>[]>;+{{% md %}} + +Nested block describing a graph definition. The structure of this block is described below. Multiple graph blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
readOnly?: pulumi.Input<boolean>;+{{% md %}} + +The read-only status of the timeboard. Default is false. + +{{% /md %}} +
templateVariables?: pulumi.Input<pulumi.Input<{ + default: pulumi.Input<string>; + name: pulumi.Input<string>; + prefix: pulumi.Input<string>; +}>[]>;+{{% md %}} + +Nested block describing a template variable. The structure of this block is described below. Multiple template_variable blocks are allowed within a datadog_timeboard resource. + +{{% /md %}} +
title?: pulumi.Input<string>;+{{% md %}} + +The name of the dashboard. + +{{% /md %}} +
accessRole?: pulumi.Input<string>;+{{% md %}} + +Role description for user. Can be `st` (standard user), `adm` (admin user) or `ro` (read-only user). Default is `st`. + +{{% /md %}} +
disabled?: pulumi.Input<boolean>;+{{% md %}} + +Whether the user is disabled + +{{% /md %}} +
email: pulumi.Input<string>;+{{% md %}} + +Email address for user + +{{% /md %}} +
handle: pulumi.Input<string>;+{{% md %}} + +The user handle, must be a valid email. + +{{% /md %}} +
isAdmin?: pulumi.Input<boolean>;+{{% md %}} + +(Optional) Whether the user is an administrator. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
name: pulumi.Input<string>;+{{% md %}} + +Name for user + +{{% /md %}} +
role?: pulumi.Input<string>;+{{% md %}} + +Role description for user. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
accessRole?: pulumi.Input<string>;+{{% md %}} + +Role description for user. Can be `st` (standard user), `adm` (admin user) or `ro` (read-only user). Default is `st`. + +{{% /md %}} +
disabled?: pulumi.Input<boolean>;+{{% md %}} + +Whether the user is disabled + +{{% /md %}} +
email?: pulumi.Input<string>;+{{% md %}} + +Email address for user + +{{% /md %}} +
handle?: pulumi.Input<string>;+{{% md %}} + +The user handle, must be a valid email. + +{{% /md %}} +
isAdmin?: pulumi.Input<boolean>;+{{% md %}} + +(Optional) Whether the user is an administrator. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
name?: pulumi.Input<string>;+{{% md %}} + +Name for user + +{{% /md %}} +
role?: pulumi.Input<string>;+{{% md %}} + +Role description for user. **Warning**: the corresponding query parameter is ignored by the Datadog API, thus the argument would always trigger an execution plan. + +{{% /md %}} +
verified?: pulumi.Input<boolean>;+{{% md %}} + +Returns true if Datadog user is verified + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog - Amazon Web Services integration resource. This can be used to create and manage Datadog - Amazon Web Services integration. + +Update operations are currently not supported with datadog API so any change forces a new resource. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog - Amazon Web Services integration +const sandbox = new datadog.aws.Integration("sandbox", { + accountId: "1234567890", + accountSpecificNamespaceRules: { + auto_scaling: false, + opsworks: false, + }, + filterTags: ["key:value"], + hostTags: [ + "key:value", + "key2:value2", + ], + roleName: "DatadogAWSIntegrationRole", +}); +``` + +{{% /md %}} +
new Integration(name: string, args: IntegrationArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a Integration resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: IntegrationState, opts?: pulumi.CustomResourceOptions): Integration+ + +Get an existing Integration resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Integration. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public accountId: pulumi.Output<string>;+{{% md %}} + +Your AWS Account ID without dashes. + +{{% /md %}} +
public accountSpecificNamespaceRules: pulumi.Output<{[key: string]: boolean} | undefined>;+{{% md %}} + +Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the [available namespace rules API endpoint](https://api.datadoghq.com/api/v1/integration/aws/available_namespace_rules). + +{{% /md %}} +
public externalId: pulumi.Output<string>;+{{% md %}} + +AWS External ID + +{{% /md %}} +
public filterTags: pulumi.Output<string[] | undefined>;+{{% md %}} + +Array of EC2 tags (in the form `key:value`) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as `?` (for single characters) and `*` (for multiple characters) can also be used. + +{{% /md %}} +
public hostTags: pulumi.Output<string[] | undefined>;+{{% md %}} + +Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public roleName: pulumi.Output<string>;+{{% md %}} + +Your Datadog role delegation name. + +{{% /md %}} +
accountId: pulumi.Input<string>;+{{% md %}} + +Your AWS Account ID without dashes. + +{{% /md %}} +
accountSpecificNamespaceRules?: pulumi.Input<{[key: string]: pulumi.Input<boolean>}>;+{{% md %}} + +Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the [available namespace rules API endpoint](https://api.datadoghq.com/api/v1/integration/aws/available_namespace_rules). + +{{% /md %}} +
filterTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of EC2 tags (in the form `key:value`) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as `?` (for single characters) and `*` (for multiple characters) can also be used. + +{{% /md %}} +
hostTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration. + +{{% /md %}} +
roleName: pulumi.Input<string>;+{{% md %}} + +Your Datadog role delegation name. + +{{% /md %}} +
accountId?: pulumi.Input<string>;+{{% md %}} + +Your AWS Account ID without dashes. + +{{% /md %}} +
accountSpecificNamespaceRules?: pulumi.Input<{[key: string]: pulumi.Input<boolean>}>;+{{% md %}} + +Enables or disables metric collection for specific AWS namespaces for this AWS account only. A list of namespaces can be found at the [available namespace rules API endpoint](https://api.datadoghq.com/api/v1/integration/aws/available_namespace_rules). + +{{% /md %}} +
externalId?: pulumi.Input<string>;+{{% md %}} + +AWS External ID + +{{% /md %}} +
filterTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of EC2 tags (in the form `key:value`) defines a filter that Datadog use when collecting metrics from EC2. Wildcards, such as `?` (for single characters) and `*` (for multiple characters) can also be used. + +{{% /md %}} +
hostTags?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of tags (in the form key:value) to add to all hosts and metrics reporting through this integration. + +{{% /md %}} +
roleName?: pulumi.Input<string>;+{{% md %}} + +Your Datadog role delegation name. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog - Google Cloud Platform integration resource. This can be used to create and manage Datadog - Google Cloud Platform integration. + +## Example Usage + +```typescript +import * as pulumi from "@pulumi/pulumi"; +import * as datadog from "@pulumi/datadog"; + +// Create a new Datadog - Google Cloud Platform integration +const awesomeGcpProjectIntegration = new datadog.gcp.Integration("awesome_gcp_project_integration", { + clientEmail: "awesome-service-account@awesome-project-id.iam.gserviceaccount.com", + clientId: "123456789012345678901", + hostFilters: "foo:bar,buzz:lightyear", + privateKey: `-----BEGIN PRIVATE KEY----- +... +-----END PRIVATE KEY----- +`, + privateKeyId: "1234567890123456789012345678901234567890", + projectId: "awesome-project-id", +}); +``` + +{{% /md %}} +
new Integration(name: string, args: IntegrationArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a Integration resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: IntegrationState, opts?: pulumi.CustomResourceOptions): Integration+ + +Get an existing Integration resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Integration. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public clientEmail: pulumi.Output<string>;+{{% md %}} + +Your email found in your JSON service account key. + +{{% /md %}} +
public clientId: pulumi.Output<string>;+{{% md %}} + +Your ID found in your JSON service account key. + +{{% /md %}} +
public hostFilters: pulumi.Output<string | undefined>;+{{% md %}} + +Limit the GCE instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public privateKey: pulumi.Output<string>;+{{% md %}} + +Your private key name found in your JSON service account key. + +{{% /md %}} +
public privateKeyId: pulumi.Output<string>;+{{% md %}} + +Your private key ID found in your JSON service account key. + +{{% /md %}} +
public projectId: pulumi.Output<string>;+{{% md %}} + +Your Google Cloud project ID found in your JSON service account key. + +{{% /md %}} +
clientEmail: pulumi.Input<string>;+{{% md %}} + +Your email found in your JSON service account key. + +{{% /md %}} +
clientId: pulumi.Input<string>;+{{% md %}} + +Your ID found in your JSON service account key. + +{{% /md %}} +
hostFilters?: pulumi.Input<string>;+{{% md %}} + +Limit the GCE instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog. + +{{% /md %}} +
privateKey: pulumi.Input<string>;+{{% md %}} + +Your private key name found in your JSON service account key. + +{{% /md %}} +
privateKeyId: pulumi.Input<string>;+{{% md %}} + +Your private key ID found in your JSON service account key. + +{{% /md %}} +
projectId: pulumi.Input<string>;+{{% md %}} + +Your Google Cloud project ID found in your JSON service account key. + +{{% /md %}} +
clientEmail?: pulumi.Input<string>;+{{% md %}} + +Your email found in your JSON service account key. + +{{% /md %}} +
clientId?: pulumi.Input<string>;+{{% md %}} + +Your ID found in your JSON service account key. + +{{% /md %}} +
hostFilters?: pulumi.Input<string>;+{{% md %}} + +Limit the GCE instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog. + +{{% /md %}} +
privateKey?: pulumi.Input<string>;+{{% md %}} + +Your private key name found in your JSON service account key. + +{{% /md %}} +
privateKeyId?: pulumi.Input<string>;+{{% md %}} + +Your private key ID found in your JSON service account key. + +{{% /md %}} +
projectId?: pulumi.Input<string>;+{{% md %}} + +Your Google Cloud project ID found in your JSON service account key. + +{{% /md %}} +
extends CustomResource+{{% md %}} + +Provides a Datadog - PagerDuty resource. This can be used to create and manage Datadog - PagerDuty integration. + +{{% /md %}} +
new Integration(name: string, args: IntegrationArgs, opts?: pulumi.CustomResourceOptions)+ + +Create a Integration resource with the given unique name, arguments, and options. + +* `name` The _unique_ name of the resource. +* `args` The arguments to use to populate this resource's properties. +* `opts` A bag of options that control this resource's behavior. + +{{% /md %}} +
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: IntegrationState, opts?: pulumi.CustomResourceOptions): Integration+ + +Get an existing Integration resource's state with the given name, ID, and optional extra +properties used to qualify the lookup. + +{{% /md %}} +
public static isInstance(obj: any): boolean+ + +Returns true if the given object is an instance of Integration. This is designed to work even +when multiple copies of the Pulumi SDK have been loaded into the same process. + +{{% /md %}} +
public apiToken: pulumi.Output<string | undefined>;+{{% md %}} + +Your PagerDuty API token. + +{{% /md %}} +
id: Output<ID>;+{{% md %}} + +id is the provider-assigned unique ID for this managed resource. It is set during +deployments and may be missing (undefined) during planning phases. + +{{% /md %}} +
public schedules: pulumi.Output<string[] | undefined>;+{{% md %}} + +Array of your schedule URLs. + +{{% /md %}} +
public services: pulumi.Output<{ + serviceKey: string; + serviceName: string; +}[]>;+{{% md %}} + +Array of PagerDuty service objects. + +{{% /md %}} +
public subdomain: pulumi.Output<string>;+{{% md %}} + +Your PagerDuty account’s personalized subdomain name. + +{{% /md %}} +
apiToken?: pulumi.Input<string>;+{{% md %}} + +Your PagerDuty API token. + +{{% /md %}} +
schedules?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of your schedule URLs. + +{{% /md %}} +
services: pulumi.Input<pulumi.Input<{ + serviceKey: pulumi.Input<string>; + serviceName: pulumi.Input<string>; +}>[]>;+{{% md %}} + +Array of PagerDuty service objects. + +{{% /md %}} +
subdomain: pulumi.Input<string>;+{{% md %}} + +Your PagerDuty account’s personalized subdomain name. + +{{% /md %}} +
apiToken?: pulumi.Input<string>;+{{% md %}} + +Your PagerDuty API token. + +{{% /md %}} +
schedules?: pulumi.Input<pulumi.Input<string>[]>;+{{% md %}} + +Array of your schedule URLs. + +{{% /md %}} +
services?: pulumi.Input<pulumi.Input<{ + serviceKey: pulumi.Input<string>; + serviceName: pulumi.Input<string>; +}>[]>;+{{% md %}} + +Array of PagerDuty service objects. + +{{% /md %}} +
subdomain?: pulumi.Input<string>;+{{% md %}} + +Your PagerDuty account’s personalized subdomain name. + +{{% /md %}} +