import * as pulumi from "@pulumi/pulumi"; import * as inputs from "./types/input"; import * as outputs from "./types/output"; /** * > This resource is excluded by default in the export utility. * * > This resource requires the API token scopes **Read configuration** (`ReadConfig`) and **Write configuration** (`WriteConfig`) * * ## Dynatrace Documentation * * - Amazon Web Services - https://www.dynatrace.com/support/help/setup-and-configuration/setup-on-cloud-platforms/amazon-web-services/amazon-web-services-integrations/aws-service-metrics * * - The dimensions and statistics for metrics for individual services - https://docs.dynatrace.com/docs/ingest-from/amazon-web-services/integrate-with-aws/aws-all-services * * - AWS credentials API - https://www.dynatrace.com/support/help/dynatrace-api/configuration-api/aws-credentials-api * * ## Resource Example Usage * * This example utilizes the data source `dynatrace.getAwsSupportedServices` in order to query for a full list of all supported services. * The `forEach` loop within the resource `dynatrace.AwsService` configures each of these services to get utilized with the default metrics recommended by Dynatrace (`useRecommendedMetrics`). * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as dynatrace from "@pulumiverse/dynatrace"; * * export = async () => { * const tERRAFORMSAMPLE = new dynatrace.AwsCredentials("tERRAFORMSAMPLE", { * label: "TERRAFORM-TEST-001", * partitionType: "AWS_DEFAULT", * taggedOnly: false, * authenticationData: { * accountId: "246186168471", * iamRole: "Dynatrace_monitoring_role_demo1", * }, * removeDefaults: true, * }); * const supportedServices = await dynatrace.getAwsSupportedServices({}); * const tERRAFORMSAMPLEServices: dynatrace.AwsService[] = []; * for (const range of Object.entries(supportedServices.services).map(([k, v]) => ({key: k, value: v}))) { * tERRAFORMSAMPLEServices.push(new dynatrace.AwsService(`tERRAFORMSAMPLEServices-${range.key}`, { * credentialsId: tERRAFORMSAMPLE.id, * useRecommendedMetrics: true, * })); * } * } * ``` * * If you want to configure a different set of metrics for a specific service, a separate resource `dynatrace.AwsService` will be necessary for that. That allows you to configure the `metric` blocks according to your wishes. * Just be aware of the fact, that Dynatrace enforces for most services a recommended set of metrics. All of them need to be part of your configuration in order to end up with a non-empty plan. * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as dynatrace from "@pulumiverse/dynatrace"; * * const example = new dynatrace.AwsCredentials("example", { * label: "#name#", * partitionType: "AWS_DEFAULT", * taggedOnly: false, * authenticationData: { * accountId: "123456789", * iamRole: "aws-monitoring-role", * }, * }); * const elastiCache = new dynatrace.AwsService("elastiCache", { * credentialsId: example.id, * metrics: [ * { * name: "NetworkBandwidthOutAllowanceExceeded", * dimensions: ["CacheClusterId"], * statistic: "SUM", * }, * { * name: "CPUUtilization", * dimensions: ["CacheClusterId"], * statistic: "AVG_MIN_MAX", * }, * ], * }); * ``` */ export declare class AwsService extends pulumi.CustomResource { /** * Get an existing AwsService resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: AwsServiceState, opts?: pulumi.CustomResourceOptions): AwsService; /** * Returns true if the given object is an instance of AwsService. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is AwsService; /** * This attribute is automatically set to `true` if Dynatrace considers the supporting service with the given name to be a built-in service */ readonly builtIn: pulumi.Output; /** * the ID of the AWS credentials this supported service belongs to */ readonly credentialsId: pulumi.Output; readonly metrics: pulumi.Output; /** * The name of the supporting service. */ readonly name: pulumi.Output; readonly requiredMetrics: pulumi.Output; readonly useRecommendedMetrics: pulumi.Output; /** * Create a AwsService resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: AwsServiceArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering AwsService resources. */ export interface AwsServiceState { /** * This attribute is automatically set to `true` if Dynatrace considers the supporting service with the given name to be a built-in service */ builtIn?: pulumi.Input; /** * the ID of the AWS credentials this supported service belongs to */ credentialsId?: pulumi.Input; metrics?: pulumi.Input[]>; /** * The name of the supporting service. */ name?: pulumi.Input; requiredMetrics?: pulumi.Input; useRecommendedMetrics?: pulumi.Input; } /** * The set of arguments for constructing a AwsService resource. */ export interface AwsServiceArgs { /** * the ID of the AWS credentials this supported service belongs to */ credentialsId: pulumi.Input; metrics?: pulumi.Input[]>; /** * The name of the supporting service. */ name?: pulumi.Input; useRecommendedMetrics?: pulumi.Input; }