datadog.LogsCustomDestination
Explore with Pulumi AI
Provides a Datadog Logs Custom Destination API resource, which is used to create and manage Datadog log forwarding.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as datadog from "@pulumi/datadog";
const sampleDestination = new datadog.LogsCustomDestination("sample_destination", {
name: "sample destination",
query: "service:my-service",
enabled: true,
httpDestination: {
endpoint: "https://example.org",
basicAuth: {
username: "my-username",
password: "my-password",
},
},
});
import pulumi
import pulumi_datadog as datadog
sample_destination = datadog.LogsCustomDestination("sample_destination",
name="sample destination",
query="service:my-service",
enabled=True,
http_destination={
"endpoint": "https://example.org",
"basic_auth": {
"username": "my-username",
"password": "my-password",
},
})
package main
import (
"github.com/pulumi/pulumi-datadog/sdk/v4/go/datadog"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := datadog.NewLogsCustomDestination(ctx, "sample_destination", &datadog.LogsCustomDestinationArgs{
Name: pulumi.String("sample destination"),
Query: pulumi.String("service:my-service"),
Enabled: pulumi.Bool(true),
HttpDestination: &datadog.LogsCustomDestinationHttpDestinationArgs{
Endpoint: pulumi.String("https://example.org"),
BasicAuth: &datadog.LogsCustomDestinationHttpDestinationBasicAuthArgs{
Username: pulumi.String("my-username"),
Password: pulumi.String("my-password"),
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Datadog = Pulumi.Datadog;
return await Deployment.RunAsync(() =>
{
var sampleDestination = new Datadog.LogsCustomDestination("sample_destination", new()
{
Name = "sample destination",
Query = "service:my-service",
Enabled = true,
HttpDestination = new Datadog.Inputs.LogsCustomDestinationHttpDestinationArgs
{
Endpoint = "https://example.org",
BasicAuth = new Datadog.Inputs.LogsCustomDestinationHttpDestinationBasicAuthArgs
{
Username = "my-username",
Password = "my-password",
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.datadog.LogsCustomDestination;
import com.pulumi.datadog.LogsCustomDestinationArgs;
import com.pulumi.datadog.inputs.LogsCustomDestinationHttpDestinationArgs;
import com.pulumi.datadog.inputs.LogsCustomDestinationHttpDestinationBasicAuthArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var sampleDestination = new LogsCustomDestination("sampleDestination", LogsCustomDestinationArgs.builder()
.name("sample destination")
.query("service:my-service")
.enabled(true)
.httpDestination(LogsCustomDestinationHttpDestinationArgs.builder()
.endpoint("https://example.org")
.basicAuth(LogsCustomDestinationHttpDestinationBasicAuthArgs.builder()
.username("my-username")
.password("my-password")
.build())
.build())
.build());
}
}
resources:
sampleDestination:
type: datadog:LogsCustomDestination
name: sample_destination
properties:
name: sample destination
query: service:my-service
enabled: true
httpDestination:
endpoint: https://example.org
basicAuth:
username: my-username
password: my-password
Create LogsCustomDestination Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new LogsCustomDestination(name: string, args: LogsCustomDestinationArgs, opts?: CustomResourceOptions);
@overload
def LogsCustomDestination(resource_name: str,
args: LogsCustomDestinationArgs,
opts: Optional[ResourceOptions] = None)
@overload
def LogsCustomDestination(resource_name: str,
opts: Optional[ResourceOptions] = None,
name: Optional[str] = None,
elasticsearch_destination: Optional[LogsCustomDestinationElasticsearchDestinationArgs] = None,
enabled: Optional[bool] = None,
forward_tags: Optional[bool] = None,
forward_tags_restriction_list_type: Optional[str] = None,
forward_tags_restriction_lists: Optional[Sequence[str]] = None,
http_destination: Optional[LogsCustomDestinationHttpDestinationArgs] = None,
query: Optional[str] = None,
splunk_destination: Optional[LogsCustomDestinationSplunkDestinationArgs] = None)
func NewLogsCustomDestination(ctx *Context, name string, args LogsCustomDestinationArgs, opts ...ResourceOption) (*LogsCustomDestination, error)
public LogsCustomDestination(string name, LogsCustomDestinationArgs args, CustomResourceOptions? opts = null)
public LogsCustomDestination(String name, LogsCustomDestinationArgs args)
public LogsCustomDestination(String name, LogsCustomDestinationArgs args, CustomResourceOptions options)
type: datadog:LogsCustomDestination
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args LogsCustomDestinationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args LogsCustomDestinationArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args LogsCustomDestinationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LogsCustomDestinationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args LogsCustomDestinationArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var logsCustomDestinationResource = new Datadog.LogsCustomDestination("logsCustomDestinationResource", new()
{
Name = "string",
ElasticsearchDestination = new Datadog.Inputs.LogsCustomDestinationElasticsearchDestinationArgs
{
BasicAuth = new Datadog.Inputs.LogsCustomDestinationElasticsearchDestinationBasicAuthArgs
{
Password = "string",
Username = "string",
},
Endpoint = "string",
IndexName = "string",
IndexRotation = "string",
},
Enabled = false,
ForwardTags = false,
ForwardTagsRestrictionListType = "string",
ForwardTagsRestrictionLists = new[]
{
"string",
},
HttpDestination = new Datadog.Inputs.LogsCustomDestinationHttpDestinationArgs
{
Endpoint = "string",
BasicAuth = new Datadog.Inputs.LogsCustomDestinationHttpDestinationBasicAuthArgs
{
Password = "string",
Username = "string",
},
CustomHeaderAuth = new Datadog.Inputs.LogsCustomDestinationHttpDestinationCustomHeaderAuthArgs
{
HeaderName = "string",
HeaderValue = "string",
},
},
Query = "string",
SplunkDestination = new Datadog.Inputs.LogsCustomDestinationSplunkDestinationArgs
{
AccessToken = "string",
Endpoint = "string",
},
});
example, err := datadog.NewLogsCustomDestination(ctx, "logsCustomDestinationResource", &datadog.LogsCustomDestinationArgs{
Name: pulumi.String("string"),
ElasticsearchDestination: &datadog.LogsCustomDestinationElasticsearchDestinationArgs{
BasicAuth: &datadog.LogsCustomDestinationElasticsearchDestinationBasicAuthArgs{
Password: pulumi.String("string"),
Username: pulumi.String("string"),
},
Endpoint: pulumi.String("string"),
IndexName: pulumi.String("string"),
IndexRotation: pulumi.String("string"),
},
Enabled: pulumi.Bool(false),
ForwardTags: pulumi.Bool(false),
ForwardTagsRestrictionListType: pulumi.String("string"),
ForwardTagsRestrictionLists: pulumi.StringArray{
pulumi.String("string"),
},
HttpDestination: &datadog.LogsCustomDestinationHttpDestinationArgs{
Endpoint: pulumi.String("string"),
BasicAuth: &datadog.LogsCustomDestinationHttpDestinationBasicAuthArgs{
Password: pulumi.String("string"),
Username: pulumi.String("string"),
},
CustomHeaderAuth: &datadog.LogsCustomDestinationHttpDestinationCustomHeaderAuthArgs{
HeaderName: pulumi.String("string"),
HeaderValue: pulumi.String("string"),
},
},
Query: pulumi.String("string"),
SplunkDestination: &datadog.LogsCustomDestinationSplunkDestinationArgs{
AccessToken: pulumi.String("string"),
Endpoint: pulumi.String("string"),
},
})
var logsCustomDestinationResource = new LogsCustomDestination("logsCustomDestinationResource", LogsCustomDestinationArgs.builder()
.name("string")
.elasticsearchDestination(LogsCustomDestinationElasticsearchDestinationArgs.builder()
.basicAuth(LogsCustomDestinationElasticsearchDestinationBasicAuthArgs.builder()
.password("string")
.username("string")
.build())
.endpoint("string")
.indexName("string")
.indexRotation("string")
.build())
.enabled(false)
.forwardTags(false)
.forwardTagsRestrictionListType("string")
.forwardTagsRestrictionLists("string")
.httpDestination(LogsCustomDestinationHttpDestinationArgs.builder()
.endpoint("string")
.basicAuth(LogsCustomDestinationHttpDestinationBasicAuthArgs.builder()
.password("string")
.username("string")
.build())
.customHeaderAuth(LogsCustomDestinationHttpDestinationCustomHeaderAuthArgs.builder()
.headerName("string")
.headerValue("string")
.build())
.build())
.query("string")
.splunkDestination(LogsCustomDestinationSplunkDestinationArgs.builder()
.accessToken("string")
.endpoint("string")
.build())
.build());
logs_custom_destination_resource = datadog.LogsCustomDestination("logsCustomDestinationResource",
name="string",
elasticsearch_destination={
"basic_auth": {
"password": "string",
"username": "string",
},
"endpoint": "string",
"index_name": "string",
"index_rotation": "string",
},
enabled=False,
forward_tags=False,
forward_tags_restriction_list_type="string",
forward_tags_restriction_lists=["string"],
http_destination={
"endpoint": "string",
"basic_auth": {
"password": "string",
"username": "string",
},
"custom_header_auth": {
"header_name": "string",
"header_value": "string",
},
},
query="string",
splunk_destination={
"access_token": "string",
"endpoint": "string",
})
const logsCustomDestinationResource = new datadog.LogsCustomDestination("logsCustomDestinationResource", {
name: "string",
elasticsearchDestination: {
basicAuth: {
password: "string",
username: "string",
},
endpoint: "string",
indexName: "string",
indexRotation: "string",
},
enabled: false,
forwardTags: false,
forwardTagsRestrictionListType: "string",
forwardTagsRestrictionLists: ["string"],
httpDestination: {
endpoint: "string",
basicAuth: {
password: "string",
username: "string",
},
customHeaderAuth: {
headerName: "string",
headerValue: "string",
},
},
query: "string",
splunkDestination: {
accessToken: "string",
endpoint: "string",
},
});
type: datadog:LogsCustomDestination
properties:
elasticsearchDestination:
basicAuth:
password: string
username: string
endpoint: string
indexName: string
indexRotation: string
enabled: false
forwardTags: false
forwardTagsRestrictionListType: string
forwardTagsRestrictionLists:
- string
httpDestination:
basicAuth:
password: string
username: string
customHeaderAuth:
headerName: string
headerValue: string
endpoint: string
name: string
query: string
splunkDestination:
accessToken: string
endpoint: string
LogsCustomDestination Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The LogsCustomDestination resource accepts the following input properties:
- Name string
- The custom destination name.
- Elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- Enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<string>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - Http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- Query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- Splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- Name string
- The custom destination name.
- Elasticsearch
Destination LogsCustom Destination Elasticsearch Destination Args - The Elasticsearch destination.
- Enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - []string
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - Http
Destination LogsCustom Destination Http Destination Args - The HTTP destination.
- Query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- Splunk
Destination LogsCustom Destination Splunk Destination Args - The Splunk HTTP Event Collector (HEC) destination.
- name String
- The custom destination name.
- elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- enabled Boolean
- Whether logs matching this custom destination should be forwarded or not.
- Boolean
- Whether tags from the forwarded logs should be forwarded or not.
- String
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<String>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- query String
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- name string
- The custom destination name.
- elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- enabled boolean
- Whether logs matching this custom destination should be forwarded or not.
- boolean
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - string[]
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- name str
- The custom destination name.
- elasticsearch_
destination LogsCustom Destination Elasticsearch Destination Args - The Elasticsearch destination.
- enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- str
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - Sequence[str]
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http_
destination LogsCustom Destination Http Destination Args - The HTTP destination.
- query str
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk_
destination LogsCustom Destination Splunk Destination Args - The Splunk HTTP Event Collector (HEC) destination.
- name String
- The custom destination name.
- elasticsearch
Destination Property Map - The Elasticsearch destination.
- enabled Boolean
- Whether logs matching this custom destination should be forwarded or not.
- Boolean
- Whether tags from the forwarded logs should be forwarded or not.
- String
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<String>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination Property Map - The HTTP destination.
- query String
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination Property Map - The Splunk HTTP Event Collector (HEC) destination.
Outputs
All input properties are implicitly available as output properties. Additionally, the LogsCustomDestination resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing LogsCustomDestination Resource
Get an existing LogsCustomDestination resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: LogsCustomDestinationState, opts?: CustomResourceOptions): LogsCustomDestination
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
elasticsearch_destination: Optional[LogsCustomDestinationElasticsearchDestinationArgs] = None,
enabled: Optional[bool] = None,
forward_tags: Optional[bool] = None,
forward_tags_restriction_list_type: Optional[str] = None,
forward_tags_restriction_lists: Optional[Sequence[str]] = None,
http_destination: Optional[LogsCustomDestinationHttpDestinationArgs] = None,
name: Optional[str] = None,
query: Optional[str] = None,
splunk_destination: Optional[LogsCustomDestinationSplunkDestinationArgs] = None) -> LogsCustomDestination
func GetLogsCustomDestination(ctx *Context, name string, id IDInput, state *LogsCustomDestinationState, opts ...ResourceOption) (*LogsCustomDestination, error)
public static LogsCustomDestination Get(string name, Input<string> id, LogsCustomDestinationState? state, CustomResourceOptions? opts = null)
public static LogsCustomDestination get(String name, Output<String> id, LogsCustomDestinationState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- Enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<string>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - Http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- Name string
- The custom destination name.
- Query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- Splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- Elasticsearch
Destination LogsCustom Destination Elasticsearch Destination Args - The Elasticsearch destination.
- Enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - []string
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - Http
Destination LogsCustom Destination Http Destination Args - The HTTP destination.
- Name string
- The custom destination name.
- Query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- Splunk
Destination LogsCustom Destination Splunk Destination Args - The Splunk HTTP Event Collector (HEC) destination.
- elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- enabled Boolean
- Whether logs matching this custom destination should be forwarded or not.
- Boolean
- Whether tags from the forwarded logs should be forwarded or not.
- String
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<String>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- name String
- The custom destination name.
- query String
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- elasticsearch
Destination LogsCustom Destination Elasticsearch Destination - The Elasticsearch destination.
- enabled boolean
- Whether logs matching this custom destination should be forwarded or not.
- boolean
- Whether tags from the forwarded logs should be forwarded or not.
- string
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - string[]
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination LogsCustom Destination Http Destination - The HTTP destination.
- name string
- The custom destination name.
- query string
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination LogsCustom Destination Splunk Destination - The Splunk HTTP Event Collector (HEC) destination.
- elasticsearch_
destination LogsCustom Destination Elasticsearch Destination Args - The Elasticsearch destination.
- enabled bool
- Whether logs matching this custom destination should be forwarded or not.
- bool
- Whether tags from the forwarded logs should be forwarded or not.
- str
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - Sequence[str]
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http_
destination LogsCustom Destination Http Destination Args - The HTTP destination.
- name str
- The custom destination name.
- query str
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk_
destination LogsCustom Destination Splunk Destination Args - The Splunk HTTP Event Collector (HEC) destination.
- elasticsearch
Destination Property Map - The Elasticsearch destination.
- enabled Boolean
- Whether logs matching this custom destination should be forwarded or not.
- Boolean
- Whether tags from the forwarded logs should be forwarded or not.
- String
- How the
forward_tags_restriction_list
parameter should be interpreted. IfALLOW_LIST
, then only tags whose keys on the forwarded logs match the ones on the restriction list are forwarded.BLOCK_LIST
works the opposite way. It does not forward the tags matching the ones on the list. Valid values areALLOW_LIST
,BLOCK_LIST
. - List<String>
- List of tag keys to be filtered.
An empty list represents no restriction is in place and either all or no tags will be
forwarded depending on
forward_tags_restriction_list_type
parameter. - http
Destination Property Map - The HTTP destination.
- name String
- The custom destination name.
- query String
- The custom destination query filter. Logs matching this query are forwarded to the destination.
- splunk
Destination Property Map - The Splunk HTTP Event Collector (HEC) destination.
Supporting Types
LogsCustomDestinationElasticsearchDestination, LogsCustomDestinationElasticsearchDestinationArgs
- Basic
Auth LogsCustom Destination Elasticsearch Destination Basic Auth - Basic access authentication.
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- Index
Name string - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- Index
Rotation string - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
- Basic
Auth LogsCustom Destination Elasticsearch Destination Basic Auth - Basic access authentication.
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- Index
Name string - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- Index
Rotation string - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
- basic
Auth LogsCustom Destination Elasticsearch Destination Basic Auth - Basic access authentication.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- index
Name String - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- index
Rotation String - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
- basic
Auth LogsCustom Destination Elasticsearch Destination Basic Auth - Basic access authentication.
- endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- index
Name string - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- index
Rotation string - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
- basic_
auth LogsCustom Destination Elasticsearch Destination Basic Auth - Basic access authentication.
- endpoint str
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- index_
name str - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- index_
rotation str - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
- basic
Auth Property Map - Basic access authentication.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- index
Name String - Name of the Elasticsearch index (must follow Elasticsearch's criteria).
- index
Rotation String - Date pattern with US locale and UTC timezone to be appended to the index name after adding '-' (that is, '${index_name}-${indexPattern}'). You can customize the index rotation naming pattern by choosing one of these options: - Hourly: 'yyyy-MM-dd-HH' (as an example, it would render: '2022-10-19-09') - Daily: 'yyyy-MM-dd' (as an example, it would render: '2022-10-19') - Weekly: 'yyyy-'W'ww' (as an example, it would render: '2022-W42') - Monthly: 'yyyy-MM' (as an example, it would render: '2022-10') If this field is missing or is blank, it means that the index name will always be the same (that is, no rotation).
LogsCustomDestinationElasticsearchDestinationBasicAuth, LogsCustomDestinationElasticsearchDestinationBasicAuthArgs
LogsCustomDestinationHttpDestination, LogsCustomDestinationHttpDestinationArgs
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- Basic
Auth LogsCustom Destination Http Destination Basic Auth - Basic access authentication.
- Custom
Header LogsAuth Custom Destination Http Destination Custom Header Auth - Custom header access authentication.
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- Basic
Auth LogsCustom Destination Http Destination Basic Auth - Basic access authentication.
- Custom
Header LogsAuth Custom Destination Http Destination Custom Header Auth - Custom header access authentication.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- basic
Auth LogsCustom Destination Http Destination Basic Auth - Basic access authentication.
- custom
Header LogsAuth Custom Destination Http Destination Custom Header Auth - Custom header access authentication.
- endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- basic
Auth LogsCustom Destination Http Destination Basic Auth - Basic access authentication.
- custom
Header LogsAuth Custom Destination Http Destination Custom Header Auth - Custom header access authentication.
- endpoint str
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- basic_
auth LogsCustom Destination Http Destination Basic Auth - Basic access authentication.
- custom_
header_ Logsauth Custom Destination Http Destination Custom Header Auth - Custom header access authentication.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- basic
Auth Property Map - Basic access authentication.
- custom
Header Property MapAuth - Custom header access authentication.
LogsCustomDestinationHttpDestinationBasicAuth, LogsCustomDestinationHttpDestinationBasicAuthArgs
LogsCustomDestinationHttpDestinationCustomHeaderAuth, LogsCustomDestinationHttpDestinationCustomHeaderAuthArgs
- Header
Name string - The header name of the authentication.
- Header
Value string - The header value of the authentication. This field is not returned by the API.
- Header
Name string - The header name of the authentication.
- Header
Value string - The header value of the authentication. This field is not returned by the API.
- header
Name String - The header name of the authentication.
- header
Value String - The header value of the authentication. This field is not returned by the API.
- header
Name string - The header name of the authentication.
- header
Value string - The header value of the authentication. This field is not returned by the API.
- header_
name str - The header name of the authentication.
- header_
value str - The header value of the authentication. This field is not returned by the API.
- header
Name String - The header name of the authentication.
- header
Value String - The header value of the authentication. This field is not returned by the API.
LogsCustomDestinationSplunkDestination, LogsCustomDestinationSplunkDestinationArgs
- Access
Token string - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- Access
Token string - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- Endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- access
Token String - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- access
Token string - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- endpoint string
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- access_
token str - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- endpoint str
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
- access
Token String - Access token of the Splunk HTTP Event Collector. This field is not returned by the API.
- endpoint String
- The destination for which logs will be forwarded to. Must have HTTPS scheme. Forwarding back to Datadog is not allowed.
Import
Custom destinations can be imported using the destination ID. Caution: auth credentials can not be imported.
$ pulumi import datadog:index/logsCustomDestination:LogsCustomDestination sample_destination "destination-id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Datadog pulumi/pulumi-datadog
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
datadog
Terraform Provider.