software.amazon.awscdk.services.apprunner

Class CfnObservabilityConfiguration

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.CfnElement

software.amazon.awscdk.core.CfnRefElement

software.amazon.awscdk.core.CfnResource

software.amazon.awscdk.services.apprunner.CfnObservabilityConfiguration

All Implemented Interfaces:

IConstruct, IDependable, IInspectable

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:43.531Z")
public class CfnObservabilityConfiguration
extends CfnResource
implements IInspectable

A CloudFormation `AWS::AppRunner::ObservabilityConfiguration`.

Specify an AWS App Runner observability configuration by using the AWS::AppRunner::ObservabilityConfiguration resource in an AWS CloudFormation template.

The AWS::AppRunner::ObservabilityConfiguration resource is an AWS App Runner resource type that specifies an App Runner observability configuration.

App Runner requires this resource when you specify App Runner services and you want to enable non-default observability features. You can share an observability configuration across multiple services.

Create multiple revisions of a configuration by specifying this resource multiple times using the same ObservabilityConfigurationName . App Runner creates multiple resources with incremental ObservabilityConfigurationRevision values. When you specify a service and configure an observability configuration resource, the service uses the latest active revision of the observability configuration by default. You can optionally configure the service to use a specific revision.

The observability configuration resource is designed to configure multiple features (currently one feature, tracing). This resource takes optional parameters that describe the configuration of these features (currently one parameter, TraceConfiguration ). If you don't specify a feature parameter, App Runner doesn't enable the feature.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.apprunner.*;
 CfnObservabilityConfiguration cfnObservabilityConfiguration = CfnObservabilityConfiguration.Builder.create(this, "MyCfnObservabilityConfiguration")
         .observabilityConfigurationName("observabilityConfigurationName")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .traceConfiguration(TraceConfigurationProperty.builder()
                 .vendor("vendor")
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CfnObservabilityConfiguration.Builder A fluent builder for CfnObservabilityConfiguration.
static interface	CfnObservabilityConfiguration.TraceConfigurationProperty Describes the configuration of the tracing feature within an AWS App Runner observability configuration.

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

IConstruct.Jsii$Default

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CFN_RESOURCE_TYPE_NAME The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor and Description
	CfnObservabilityConfiguration(Construct scope, java.lang.String id) Create a new `AWS::AppRunner::ObservabilityConfiguration`.
	CfnObservabilityConfiguration(Construct scope, java.lang.String id, CfnObservabilityConfigurationProps props) Create a new `AWS::AppRunner::ObservabilityConfiguration`.
protected	CfnObservabilityConfiguration(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnObservabilityConfiguration(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
IResolvable	getAttrLatest() It's set to `true` for the configuration with the highest `Revision` among all configurations that share the same `ObservabilityConfigurationName` .
java.lang.String	getAttrObservabilityConfigurationArn() The Amazon Resource Name (ARN) of this observability configuration.
java.lang.Number	getAttrObservabilityConfigurationRevision() The revision of this observability configuration.
protected java.util.Map<java.lang.String,java.lang.Object>	getCfnProperties()
java.lang.String	getObservabilityConfigurationName() A name for the observability configuration.
TagManager	getTags() A list of metadata items that you can associate with your observability configuration resource.
java.lang.Object	getTraceConfiguration() The configuration of the tracing feature within this observability configuration.
void	inspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.
protected java.util.Map<java.lang.String,java.lang.Object>	renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
void	setObservabilityConfigurationName(java.lang.String value) A name for the observability configuration.
void	setTraceConfiguration(CfnObservabilityConfiguration.TraceConfigurationProperty value) The configuration of the tracing feature within this observability configuration.
void	setTraceConfiguration(IResolvable value) The configuration of the tracing feature within this observability configuration.

Methods inherited from class software.amazon.awscdk.core.CfnResource

addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.core.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.core.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CFN_RESOURCE_TYPE_NAME

public static final java.lang.String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Detail

CfnObservabilityConfiguration

protected CfnObservabilityConfiguration(software.amazon.jsii.JsiiObjectRef objRef)

CfnObservabilityConfiguration

protected CfnObservabilityConfiguration(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnObservabilityConfiguration

public CfnObservabilityConfiguration(Construct scope,
                                     java.lang.String id,
                                     CfnObservabilityConfigurationProps props)

Create a new `AWS::AppRunner::ObservabilityConfiguration`.

Parameters:

scope - - scope in which this resource is defined. This parameter is required.

id - - scoped id of the resource. This parameter is required.

props - - resource properties.

CfnObservabilityConfiguration

public CfnObservabilityConfiguration(Construct scope,
                                     java.lang.String id)

Create a new `AWS::AppRunner::ObservabilityConfiguration`.

Parameters:

scope - - scope in which this resource is defined. This parameter is required.

id - - scoped id of the resource. This parameter is required.

Method Detail

inspect

public void inspect(TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - - tree inspector to collect and process attributes. This parameter is required.

renderProperties

protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrLatest

public IResolvable getAttrLatest()

It's set to `true` for the configuration with the highest `Revision` among all configurations that share the same `ObservabilityConfigurationName` .

It's set to false otherwise.

getAttrObservabilityConfigurationArn

public java.lang.String getAttrObservabilityConfigurationArn()

The Amazon Resource Name (ARN) of this observability configuration.

getAttrObservabilityConfigurationRevision

public java.lang.Number getAttrObservabilityConfigurationRevision()

The revision of this observability configuration.

It's unique among all the active configurations ( "Status": "ACTIVE" ) that share the same ObservabilityConfigurationName .

getCfnProperties

protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getTags

public TagManager getTags()

A list of metadata items that you can associate with your observability configuration resource.

A tag is a key-value pair.

getObservabilityConfigurationName

public java.lang.String getObservabilityConfigurationName()

A name for the observability configuration.

When you use it for the first time in an AWS Region , App Runner creates revision number 1 of this name. When you use the same name in subsequent calls, App Runner creates incremental revisions of the configuration.

The name DefaultConfiguration is reserved. You can't use it to create a new observability configuration, and you can't create a revision of it.

When you want to use your own observability configuration for your App Runner service, create a configuration with a different name , and then provide it when you create or update your service.

If you don't specify a name, AWS CloudFormation generates a name for your observability configuration.

setObservabilityConfigurationName

public void setObservabilityConfigurationName(java.lang.String value)

A name for the observability configuration.

When you use it for the first time in an AWS Region , App Runner creates revision number 1 of this name. When you use the same name in subsequent calls, App Runner creates incremental revisions of the configuration.

The name DefaultConfiguration is reserved. You can't use it to create a new observability configuration, and you can't create a revision of it.

When you want to use your own observability configuration for your App Runner service, create a configuration with a different name , and then provide it when you create or update your service.

If you don't specify a name, AWS CloudFormation generates a name for your observability configuration.

getTraceConfiguration

public java.lang.Object getTraceConfiguration()

The configuration of the tracing feature within this observability configuration.

If you don't specify it, App Runner doesn't enable tracing.

setTraceConfiguration

public void setTraceConfiguration(CfnObservabilityConfiguration.TraceConfigurationProperty value)

The configuration of the tracing feature within this observability configuration.

If you don't specify it, App Runner doesn't enable tracing.

setTraceConfiguration

public void setTraceConfiguration(IResolvable value)

The configuration of the tracing feature within this observability configuration.

If you don't specify it, App Runner doesn't enable tracing.