@aws-cdk_aws-kinesisanalytics-flink-alpha.IApplication

interface IApplication ๐Ÿ”น

LanguageType name
.NETAmazon.CDK.AWS.Kinesisanalytics.Flink.Alpha.IApplication
Gogithub.com/aws/aws-cdk-go/awscdkkinesisanalyticsflinkalpha/v2#IApplication
Javasoftware.amazon.awscdk.services.kinesisanalytics.flink.alpha.IApplication
Pythonaws_cdk.aws_kinesisanalytics_flink_alpha.IApplication
TypeScript (source)@aws-cdk/aws-kinesisanalytics-flink-alpha ยป IApplication

Implemented by Application

Obtainable from Application.fromApplicationArn(), Application.fromApplicationAttributes(), Application.fromApplicationName()

An interface expressing the public properties on both an imported and CDK-created Flink application.

Properties

NameTypeDescription
applicationArn๐Ÿ”นstringThe application ARN.
applicationName๐Ÿ”นstringThe name of the Flink application.
connections๐Ÿ”นConnectionsThe network connections associated with this resource.
env๐Ÿ”นResourceEnvironmentThe environment this resource belongs to.
grantPrincipal๐Ÿ”นIPrincipalThe principal to grant permissions to.
node๐Ÿ”นNodeThe tree node.
stack๐Ÿ”นStackThe stack in which this resource is defined.
role?๐Ÿ”นIRoleThe application IAM role.

applicationArn๐Ÿ”น

Type: string

The application ARN.


applicationName๐Ÿ”น

Type: string

The name of the Flink application.


connections๐Ÿ”น

Type: Connections

The network connections associated with this resource.


env๐Ÿ”น

Type: ResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.


grantPrincipal๐Ÿ”น

Type: IPrincipal

The principal to grant permissions to.


node๐Ÿ”น

Type: Node

The tree node.


stack๐Ÿ”น

Type: Stack

The stack in which this resource is defined.


role?๐Ÿ”น

Type: IRole (optional)

The application IAM role.

Methods

NameDescription
addToRolePolicy(policyStatement)๐Ÿ”นConvenience method for adding a policy statement to the application role.
applyRemovalPolicy(policy)๐Ÿ”นApply the given removal policy to this resource.
metric(metricName, props?)๐Ÿ”นReturn a CloudWatch metric associated with this Flink application.
metricBackPressuredTimeMsPerSecond(props?)๐Ÿ”นThe time (in milliseconds) this task or operator is back pressured per second.
metricBusyTimePerMsPerSecond(props?)๐Ÿ”นThe time (in milliseconds) this task or operator is busy (neither idle nor back pressured) per second.
metricCpuUtilization(props?)๐Ÿ”นThe overall percentage of CPU utilization across task managers.
metricCurrentInputWatermark(props?)๐Ÿ”นThe last watermark this application/operator/task/thread has received.
metricCurrentOutputWatermark(props?)๐Ÿ”นThe last watermark this application/operator/task/thread has received.
metricDowntime(props?)๐Ÿ”นThe time elapsed during an outage for failing/recovering jobs.
metricFullRestarts(props?)๐Ÿ”นThe total number of times this job has fully restarted since it was submitted.
metricHeapMemoryUtilization(props?)๐Ÿ”นOverall heap memory utilization across task managers.
metricIdleTimeMsPerSecond(props?)๐Ÿ”นThe time (in milliseconds) this task or operator is idle (has no data to process) per second.
metricKpus(props?)๐Ÿ”นThe number of Kinesis Processing Units that are used to run your stream processing application.
metricLastCheckpointDuration(props?)๐Ÿ”นThe time it took to complete the last checkpoint.
metricLastCheckpointSize(props?)๐Ÿ”นThe total size of the last checkpoint.
metricManagedMemoryTotal(props?)๐Ÿ”นThe total amount of managed memory.
metricManagedMemoryUsed(props?)๐Ÿ”นThe amount of managed memory currently used.
metricManagedMemoryUtilization(props?)๐Ÿ”นDerived from managedMemoryUsed/managedMemoryTotal.
metricNumLateRecordsDropped(props?)๐Ÿ”นThe number of records this operator or task has dropped due to arriving late.
metricNumRecordsIn(props?)๐Ÿ”นThe total number of records this application, operator, or task has received.
metricNumRecordsInPerSecond(props?)๐Ÿ”นThe total number of records this application, operator or task has received per second.
metricNumRecordsOut(props?)๐Ÿ”นThe total number of records this application, operator or task has emitted.
metricNumRecordsOutPerSecond(props?)๐Ÿ”นThe total number of records this application, operator or task has emitted per second.
metricNumberOfFailedCheckpoints(props?)๐Ÿ”นThe number of times checkpointing has failed.
metricOldGenerationGCCount(props?)๐Ÿ”นThe total number of old garbage collection operations that have occurred across all task managers.
metricOldGenerationGCTime(props?)๐Ÿ”นThe total time spent performing old garbage collection operations.
metricThreadsCount(props?)๐Ÿ”นThe total number of live threads used by the application.
metricUptime(props?)๐Ÿ”นThe time that the job has been running without interruption.

addToRolePolicy(policyStatement)๐Ÿ”น

public addToRolePolicy(policyStatement: PolicyStatement): boolean

Parameters

  • policyStatement PolicyStatement

Returns

  • boolean

Convenience method for adding a policy statement to the application role.


applyRemovalPolicy(policy)๐Ÿ”น

public applyRemovalPolicy(policy: RemovalPolicy): void

Parameters

  • policy RemovalPolicy

Apply the given removal policy to this resource.

The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you've removed it from the CDK application or because you've made a change that requires the resource to be replaced.

The resource can be deleted (RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (RemovalPolicy.RETAIN).


metric(metricName, props?)๐Ÿ”น

public metric(metricName: string, props?: MetricOptions): Metric

Parameters

  • metricName string โ€” The name of the metric.
  • props MetricOptions โ€” Customization properties.

Returns

  • Metric

Return a CloudWatch metric associated with this Flink application.


metricBackPressuredTimeMsPerSecond(props?)๐Ÿ”น

public metricBackPressuredTimeMsPerSecond(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time (in milliseconds) this task or operator is back pressured per second.

Units: Milliseconds

Reporting Level: Operator, Task, Parallelism


metricBusyTimePerMsPerSecond(props?)๐Ÿ”น

public metricBusyTimePerMsPerSecond(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time (in milliseconds) this task or operator is busy (neither idle nor back pressured) per second.

Can be NaN, if the value could not be calculated.

Units: Milliseconds

Reporting Level: Operator, Task, Parallelism


metricCpuUtilization(props?)๐Ÿ”น

public metricCpuUtilization(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The overall percentage of CPU utilization across task managers.

For example, if there are five task managers, Kinesis Data Analytics publishes five samples of this metric per reporting interval.

Units: Percentage

Reporting Level: Application


metricCurrentInputWatermark(props?)๐Ÿ”น

public metricCurrentInputWatermark(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The last watermark this application/operator/task/thread has received.

Units: Milliseconds

Reporting Level: Application, Operator, Task, Parallelism


metricCurrentOutputWatermark(props?)๐Ÿ”น

public metricCurrentOutputWatermark(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The last watermark this application/operator/task/thread has received.

Units: Milliseconds

Reporting Level: Application, Operator, Task, Parallelism


metricDowntime(props?)๐Ÿ”น

public metricDowntime(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time elapsed during an outage for failing/recovering jobs.

Units: Milliseconds

Reporting Level: Application


metricFullRestarts(props?)๐Ÿ”น

public metricFullRestarts(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of times this job has fully restarted since it was submitted.

This metric does not measure fine-grained restarts.

Units: Count

Reporting Level: Application


metricHeapMemoryUtilization(props?)๐Ÿ”น

public metricHeapMemoryUtilization(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

Overall heap memory utilization across task managers.

For example, if there are five task managers, Kinesis Data Analytics publishes five samples of this metric per reporting interval.

Units: Percentage

Reporting Level: Application


metricIdleTimeMsPerSecond(props?)๐Ÿ”น

public metricIdleTimeMsPerSecond(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time (in milliseconds) this task or operator is idle (has no data to process) per second.

Idle time excludes back pressured time, so if the task is back pressured it is not idle.

Units: Milliseconds

Reporting Level: Operator, Task, Parallelism


metricKpus(props?)๐Ÿ”น

public metricKpus(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The number of Kinesis Processing Units that are used to run your stream processing application.

The average number of KPUs used each hour determines the billing for your application.

Units: Count

Reporting Level: Application


metricLastCheckpointDuration(props?)๐Ÿ”น

public metricLastCheckpointDuration(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time it took to complete the last checkpoint.

Units: Milliseconds

Reporting Level: Application


metricLastCheckpointSize(props?)๐Ÿ”น

public metricLastCheckpointSize(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total size of the last checkpoint.

Units: Bytes

Reporting Level: Application


metricManagedMemoryTotal(props?)๐Ÿ”น

public metricManagedMemoryTotal(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total amount of managed memory.

Units: Bytes

Reporting Level: Application, Operator, Task, Parallelism


metricManagedMemoryUsed(props?)๐Ÿ”น

public metricManagedMemoryUsed(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The amount of managed memory currently used.

Units: Bytes

Reporting Level: Application, Operator, Task, Parallelism


metricManagedMemoryUtilization(props?)๐Ÿ”น

public metricManagedMemoryUtilization(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

Derived from managedMemoryUsed/managedMemoryTotal.

Units: Percentage

Reporting Level: Application, Operator, Task, Parallelism


metricNumLateRecordsDropped(props?)๐Ÿ”น

public metricNumLateRecordsDropped(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The number of records this operator or task has dropped due to arriving late.

Units: Count

Reporting Level: Application, Operator, Task, Parallelism


metricNumRecordsIn(props?)๐Ÿ”น

public metricNumRecordsIn(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of records this application, operator, or task has received.

Units: Count

Reporting Level: Application, Operator, Task, Parallelism


metricNumRecordsInPerSecond(props?)๐Ÿ”น

public metricNumRecordsInPerSecond(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of records this application, operator or task has received per second.

Units: Count/Second

Reporting Level: Application, Operator, Task, Parallelism


metricNumRecordsOut(props?)๐Ÿ”น

public metricNumRecordsOut(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of records this application, operator or task has emitted.

Units: Count

Reporting Level: Application, Operator, Task, Parallelism


metricNumRecordsOutPerSecond(props?)๐Ÿ”น

public metricNumRecordsOutPerSecond(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of records this application, operator or task has emitted per second.

Units: Count/Second

Reporting Level: Application, Operator, Task, Parallelism


metricNumberOfFailedCheckpoints(props?)๐Ÿ”น

public metricNumberOfFailedCheckpoints(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The number of times checkpointing has failed.

Units: Count

Reporting Level: Application


metricOldGenerationGCCount(props?)๐Ÿ”น

public metricOldGenerationGCCount(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of old garbage collection operations that have occurred across all task managers.

Units: Count

Reporting Level: Application


metricOldGenerationGCTime(props?)๐Ÿ”น

public metricOldGenerationGCTime(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total time spent performing old garbage collection operations.

Units: Milliseconds

Reporting Level: Application


metricThreadsCount(props?)๐Ÿ”น

public metricThreadsCount(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The total number of live threads used by the application.

Units: Count

Reporting Level: Application


metricUptime(props?)๐Ÿ”น

public metricUptime(props?: MetricOptions): Metric

Parameters

  • props MetricOptions

Returns

  • Metric

The time that the job has been running without interruption.

Units: Milliseconds

Reporting Level: Application