Options
All
  • Public
  • Public/Protected
  • All
Menu

Namespace CreateLogAnalyticsObjectCollectionRuleDetails

The configuration details of collection rule to enable automatic log collection from an object storage bucket.

Properties

Optional charEncoding

charEncoding: undefined | string

An optional character encoding to aid in detecting the character encoding of the contents of the objects while processing. It is recommended to set this value as ISO_8859_1 when configuring content of the objects having more numeric characters, and very few alphabets. For e.g. this applies when configuring VCN Flow Logs.

Optional collectionType

collectionType: model.ObjectCollectionRuleCollectionTypes

The type of collection.

compartmentId

compartmentId: string

The OCID of the compartment to which this rule belongs.

Optional definedTags

definedTags: undefined | object

Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {@code {"foo-namespace": {"bar-key": "value"}}}

Optional description

description: undefined | string

A string that describes the details of the rule. It does not have to be unique, and can be changed. Avoid entering confidential information.

Optional entityId

entityId: undefined | string

Logging Analytics entity OCID. Associates the processed logs with the given entity (optional).

Optional freeformTags

freeformTags: undefined | object

Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {@code {"bar-key": "value"}}

Optional isEnabled

isEnabled: undefined | false | true

Whether or not this rule is currently enabled.

Optional isForceHistoricCollection

isForceHistoricCollection: undefined | false | true

Flag to allow historic collection if poll period overlaps with existing ACTIVE collection rule

logGroupId

logGroupId: string

Logging Analytics Log group OCID to associate the processed logs with.

Optional logSet

logSet: undefined | string

The logSet to be associated with the processed logs. The logSet feature can be used by customers with high volume of data and this feature has to be enabled for a given tenancy prior to its usage. When logSetExtRegex value is provided, it will take precedence over this logSet value and logSet will be computed dynamically using logSetKey and logSetExtRegex.

Optional logSetExtRegex

logSetExtRegex: undefined | string

The regex to be applied against given logSetKey. Regex has to be in string escaped format.

Optional logSetKey

logSetKey: model.LogSetKeyTypes

An optional parameter to indicate from where the logSet to be extracted using logSetExtRegex. Default value is OBJECT_PATH (e.g. /n//b//o/).

logSourceName

logSourceName: string

Name of the Logging Analytics Source to use for the processing.

Optional logType

logType: model.LogTypes

Type of files/objects in this object collection rule.

name

name: string

A unique name given to the rule. The name must be unique within the tenancy, and cannot be modified.

Optional objectNameFilters

objectNameFilters: Array<string>

When the filters are provided, only the objects matching the filters are picked up for processing. The matchType supported is exact match and accommodates wildcard "*". For more information on filters, see Event Filters.

osBucketName

osBucketName: string

Name of the Object Storage bucket.

osNamespace

osNamespace: string

Object Storage namespace.

Optional overrides

overrides: undefined | object

The override is used to modify some important configuration properties for objects matching a specific pattern inside the bucket. Supported propeties for override are: logSourceName, charEncoding, entityId. Supported matchType for override are "contains".

Optional pollSince

pollSince: undefined | string

The oldest time of the file in the bucket to consider for collection. Accepted values are: BEGINNING or CURRENT_TIME or RFC3339 formatted datetime string. Use this for HISTORIC or HISTORIC_LIVE collection types. When collectionType is LIVE, specifying pollSince value other than CURRENT_TIME will result in error.

Optional pollTill

pollTill: undefined | string

The newest time of the file in the bucket to consider for collection. Accepted values are: CURRENT_TIME or RFC3339 formatted datetime string. Use this for HISTORIC collection type. When collectionType is LIVE or HISTORIC_LIVE, specifying pollTill will result in error.

Optional timezone

timezone: undefined | string

Timezone to be used when processing log entries whose timestamps do not include an explicit timezone. When this property is not specified, the timezone of the entity specified is used. If the entity is also not specified or do not have a valid timezone then UTC is used.

Functions

getDeserializedJsonObj

getJsonObj