Oracle Cloud Infrastructure Documentation
Try Free Tier

Logging Ingestion Functions

Package: DBMS_CLOUD_OCI_LOGI_LOGGING

PUT_LOGS Function

This API allows ingesting logs associated with a logId. A success response implies the data has been accepted.

Syntax

FUNCTION put_logs (
  log_id varchar2,
  put_logs_details dbms_cloud_oci_logging_ingestion_put_logs_details_t,
  timestamp_opc_agent_processing timestamp with time zone DEFAULT NULL,
  opc_agent_version varchar2 DEFAULT NULL,
  opc_request_id varchar2 DEFAULT NULL,
  region varchar2 DEFAULT NULL, 
  endpoint varchar2 DEFAULT NULL,
  credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_logi_logging_put_logs_response_t;

Parameters

Parameter Description

log_id

(required) OCID of a log to work with.

put_logs_details

(required) The logs to emit.

timestamp_opc_agent_processing

(optional) Effective timestamp, for when the agent started processing the log segment being sent. An RFC3339-formatted date-time string with milliseconds precision.

opc_agent_version

(optional) Version of the agent sending the request.

opc_request_id

(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

region

(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).

endpoint

(optional) The endpoint of the service to call using this function. e.g https://ingestion.logging.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.

credential_name

(optional) The name of the credential for authenticating with the corresponding cloud native API.

Was this article helpful?