software.amazon.awscdk.services.logs

Interface ILogGroup

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IDependable, IResource, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

ILogGroup.Jsii$Default

All Known Implementing Classes:

ILogGroup.Jsii$Proxy, LogGroup

@Generated(value="jsii-pacmak/1.29.0 (build 41df200)",
           date="2021-06-02T09:55:31.737Z")
 @Stability(value=Experimental)
public interface ILogGroup
extends software.amazon.jsii.JsiiSerializable, IResource

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ILogGroup.Jsii$Default Internal default implementation for ILogGroup.
static class	ILogGroup.Jsii$Proxy A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method and Description
MetricFilter	addMetricFilter(String id, MetricFilterOptions props) (experimental) Create a new Metric Filter on this Log Group.
LogStream	addStream(String id) (experimental) Create a new Log Stream for this Log Group.
LogStream	addStream(String id, StreamOptions props) (experimental) Create a new Log Stream for this Log Group.
SubscriptionFilter	addSubscriptionFilter(String id, SubscriptionFilterOptions props) (experimental) Create a new Subscription Filter on this Log Group.
Metric	extractMetric(String jsonField, String metricNamespace, String metricName) (experimental) Extract a metric from structured log events in the LogGroup.
String	getLogGroupArn() (experimental) The ARN of this log group, with ':*' appended.
String	getLogGroupName() (experimental) The name of this log group.
Grant	grant(IGrantable grantee, String... actions) (experimental) Give the indicated permissions on this log group and all streams.
Grant	grantWrite(IGrantable grantee) (experimental) Give permissions to write to create and write to streams in this log group.

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getLogGroupArn

@Stability(value=Experimental)
 @NotNull
String getLogGroupArn()

(experimental) The ARN of this log group, with ':*' appended.

getLogGroupName

@Stability(value=Experimental)
 @NotNull
String getLogGroupName()

(experimental) The name of this log group.

addMetricFilter

@Stability(value=Experimental)
 @NotNull
MetricFilter addMetricFilter(@NotNull
                                                                      String id,
                                                                      @NotNull
                                                                      MetricFilterOptions props)

(experimental) Create a new Metric Filter on this Log Group.

Parameters:

id - Unique identifier for the construct in its parent. This parameter is required.

props - Properties for creating the MetricFilter. This parameter is required.

addStream

@Stability(value=Experimental)
 @NotNull
LogStream addStream(@NotNull
                                                             String id,
                                                             @Nullable
                                                             StreamOptions props)

(experimental) Create a new Log Stream for this Log Group.

Parameters:

id - Unique identifier for the construct in its parent. This parameter is required.

props - Properties for creating the LogStream.

addStream

@Stability(value=Experimental)
 @NotNull
LogStream addStream(@NotNull
                                                             String id)

(experimental) Create a new Log Stream for this Log Group.

Parameters:

id - Unique identifier for the construct in its parent. This parameter is required.

addSubscriptionFilter

@Stability(value=Experimental)
 @NotNull
SubscriptionFilter addSubscriptionFilter(@NotNull
                                                                                  String id,
                                                                                  @NotNull
                                                                                  SubscriptionFilterOptions props)

(experimental) Create a new Subscription Filter on this Log Group.

Parameters:

id - Unique identifier for the construct in its parent. This parameter is required.

props - Properties for creating the SubscriptionFilter. This parameter is required.

extractMetric

@Stability(value=Experimental)
 @NotNull
Metric extractMetric(@NotNull
                                                              String jsonField,
                                                              @NotNull
                                                              String metricNamespace,
                                                              @NotNull
                                                              String metricName)

(experimental) Extract a metric from structured log events in the LogGroup.

Creates a MetricFilter on this LogGroup that will extract the value of the indicated JSON field in all records where it occurs.

The metric will be available in CloudWatch Metrics under the indicated namespace and name.

Parameters:

jsonField - JSON field to extract (example: '$.myfield'). This parameter is required.

metricNamespace - Namespace to emit the metric under. This parameter is required.

metricName - Name to emit the metric under. This parameter is required.

Returns:

A Metric object representing the extracted metric

grant

@Stability(value=Experimental)
 @NotNull
Grant grant(@NotNull
                                                     IGrantable grantee,
                                                     @NotNull
                                                     String... actions)

(experimental) Give the indicated permissions on this log group and all streams.

Parameters:

grantee - This parameter is required.

actions - This parameter is required.

grantWrite

@Stability(value=Experimental)
 @NotNull
Grant grantWrite(@NotNull
                                                          IGrantable grantee)

(experimental) Give permissions to write to create and write to streams in this log group.

Parameters:

grantee - This parameter is required.