Skip to main content
The Oracle Log Analytics destination plugin (name: oracle_log_analytics) lets you configure your telemetry pipeline to output log data to Oracle Log Analytics.

​
Supported telemetry types

The for Chronosphere Telemetry Pipeline supports these telemetry types:
LogsMetricsTraces

​
Configuration parameters

Use the parameters in this section to configure the . The Telemetry Pipeline web interface uses the items in the Name column to describe these parameters. Pipeline configuration files use the items in the Key column as YAML keys.

​
General

NameKeyDescriptionDefault
Configuration File Locationconfig_file_locationRequired. The location of the configuration file containing OCI authentication details. See SDK and CLI Configuration File for steps on generating the configuration file.~/.oci/config
Profile Nameprofile_nameRequired. OCI Config Profile Name to be used from the configuration file.DEFAULT
NamespacenamespaceRequired. OCI Tenancy Namespace in which the collected log data is to be uploaded.none
ProxyproxyDefines a proxy. Must be in the format http://host:port. Supports the HTTP protocol only.none

​
Advanced

NameKeyDescriptionDefault
OCI Config in Recordoci_la_log_group_idOptional. If set to true, the following oci_la_* parameters are read from the record itself instead of the output plugin configuration. Accepted values: true, false.false
OCI Log Group IDoci_la_log_group_idRequired. The OCID of the Logging Analytics Log Group where the logs must be stored.none
OCI Log Source Nameoci_la_log_source_nameRequired. The Logging Analytics Source that must be used to process the log records.none
OCI Entity IDoci_la_entity_idThe entity type of the Logging Analytics Entity.none
OCI Log Pathoci_la_log_pathSpecifies the original location of the log files.none
OCI Global Metadataoci_la_global_metadataSpecifies additional global metadata along with original log content to Logging Analytics. The format is key value. This option can be set multiple times.none
OCI Metadataoci_la_metadataSpecifies additional metadata for a log event along with original log content to Logging Analytics. The format is key value. This option can be set multiple times.none

​
Security and TLS

NameKeyDescriptionDefault
TLStlsIf true, enables TLS/SSL. If false, disables TLS/SSL. Accepted values: true, false.false
TLS Certificate Validationtls.verifyIf on, and if tls is true, enables TLS/SSL certificate validation. If off, disables TLS/SSL certificate validation. Accepted values: on, off.on
TLS Debug Leveltls.debugSets TLS debug verbosity level. Accepted values: 0 (No debug), 1 (Error), 2 (State change), 3 (Informational), 4 (Verbose).1
CA Certificate File Pathtls.ca_fileAbsolute path to CA certificate file.none
Certificate File Pathtls.crt_fileAbsolute path to certificate file.none
Private Key File Pathtls.key_fileAbsolute path to private key file.none
Private Key Path Passwordtls.key_passwdPassword for private key file.none
TLS SNI Hostname Extensiontls.vhostHostname to be used for TLS SNI extension.none

​
Advanced Networking

NameKeyDescriptionDefault
DNS Modenet.dns.modeSelects the primary DNS connection type, which can be TCP or UDP.none
DNS Resolvernet.dns.resolverSelects the primary DNS connection type, which can be LEGACY or ASYNC.none
Prefer IPv4net.dns.prefer_ipv4Prioritizes IPv4 DNS results when trying to establish a connection. Accepted values: true, false.false
Keepalivenet.keepaliveEnables or disables Keepalive support. Accepted values: true, false.true
Keepalive Idle Timeoutnet.keepalive_idle_timeoutSets the maximum time allowed for an idle Keepalive connection.30s
Max Connect Timeoutnet.connect_timeoutSets the maximum time allowed to establish a connection, which includes the TLS handshake.10s
Max Connect Timeout Log Errornet.connect_timeout_log_errorSpecifies whether to log an error on connection timeout. When disabled, the timeout is logged as a debug message. Accepted values: true, false.true
Max Keepalive Recyclenet.keepalive_max_recycleSets the maximum number of times a keepalive connection can be used before it’s retired.2000
Source Addressnet.source_addressSpecifies the network address to bind for data traffic.none

​
Example

The following YAML configuration defines a Fluent Bit input and an Oracle Log Analytics output. 
pipeline:
  inputs:
    - Name: forward
      alias: Fluent_Bit
      port: "5170"
      tls.verify: on
      tls.debug: "1"
      tag: forward.0dd7a9e7-ed46-4c31-bbd3-40e8b607f501
  outputs:
    - Name: oracle_log_analytics
      config_file_location: ~/.oci/config
      profile_name: DEFAULT
      namespace: NAMESPACE
      proxy: http://host:port
      oci_la_log_group_id: log_group_id
      oci_la_log_source_name: REST API
      oci_la_entity_id: entity
      oci_la_entity_type: entity_type
      oci_la_log_path: log_path
      oci_la_global_metadata:
        - key1 value1
      oci_la_metadata:
        - key2 value2
      tls: true
      tls.verify: on
      tls.debug: "1"
      net.keepalive: true
      net.keepalive_idle_timeout: 30s
      net.connect_timeout: 10s
      net.connect_timeout_log_error: true
      net.keepalive_max_recycle: "2000"
      Match_Regex: .{0,}