Interface ILogGroup

All Superinterfaces:
software.constructs.IConstruct, software.constructs.IDependable, IResource, IResourceWithPolicy, software.amazon.jsii.JsiiSerializable
All Known Subinterfaces:
ILogGroup.Jsii$Default
All Known Implementing Classes:
ILogGroup.Jsii$Proxy, LogGroup

@Generated(value="jsii-pacmak/1.99.0 (build 8f757e4)", date="2024-06-13T18:49:21.359Z") @Stability(Stable) public interface ILogGroup extends software.amazon.jsii.JsiiSerializable, IResourceWithPolicy
  • Method Details

    • getLogGroupArn

      @Stability(Stable) @NotNull String getLogGroupArn()
      The ARN of this log group, with ':*' appended.
    • getLogGroupName

      @Stability(Stable) @NotNull String getLogGroupName()
      The name of this log group.
    • addMetricFilter

      @Stability(Stable) @NotNull MetricFilter addMetricFilter(@NotNull String id, @NotNull MetricFilterOptions props)
      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(Stable) @NotNull LogStream addStream(@NotNull String id, @Nullable StreamOptions props)
      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(Stable) @NotNull LogStream addStream(@NotNull String id)
      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(Stable) @NotNull SubscriptionFilter addSubscriptionFilter(@NotNull String id, @NotNull SubscriptionFilterOptions props)
      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(Stable) @NotNull Metric extractMetric(@NotNull String jsonField, @NotNull String metricNamespace, @NotNull String metricName)
      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(Stable) @NotNull Grant grant(@NotNull IGrantable grantee, @NotNull @NotNull String... actions)
      Give the indicated permissions on this log group and all streams.

      Parameters:
      grantee - This parameter is required.
      actions - This parameter is required.
    • grantRead

      @Stability(Stable) @NotNull Grant grantRead(@NotNull IGrantable grantee)
      Give permissions to read from this log group and streams.

      Parameters:
      grantee - This parameter is required.
    • grantWrite

      @Stability(Stable) @NotNull Grant grantWrite(@NotNull IGrantable grantee)
      Give permissions to write to create and write to streams in this log group.

      Parameters:
      grantee - This parameter is required.
    • logGroupPhysicalName

      @Stability(Stable) @NotNull String logGroupPhysicalName()
      Public method to get the physical name of this log group.