Logging

00Overview

Manage Oracle Cloud Logging straight from a flow — create and organise log groups, add custom and service logs, tune their retention and enabled state, and move logs into other groups or log groups into other compartments. Search stored log content across your tenancy with Logging Query Language over a chosen time window, list the OCI services that emit logs, and list, inspect and delete the unified monitoring agent configurations that collect them. Most changes run asynchronously, so a flow can start them and then poll until they land.

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Logging

1. The node's Authentication dropdown offers two ways to connect: Connect Oracle Cloud (the default, recommended for most operators) and API signing key (advanced) for supplying an existing key pair by hand.
2. For Connect Oracle Cloud, pick or add an Oracle Cloud connection in your Flomation environment and follow its guided steps to authorise Flomation against your tenancy, providing the details it asks for such as your Tenancy OCID and Region; the connection then handles the API signing key for you.
3. For API signing key (advanced), in the OCI Console open your user's API keys (via the profile menu → My profile, or Identity & Security → Users → your user) and choose Add API key; download the private key and note the Fingerprint shown after it uploads.
4. Fill the node's Tenancy OCID, User OCID, Region (a plain identifier such as uk-london-1) and Key Fingerprint, and paste the key into Private Key (PEM) as the full PEM including its BEGIN/END lines — add a Private Key Passphrase only if the key is encrypted.
5. Store the private key as a Flomation environment secret (e.g. logging_secret) rather than pasting it inline, then select it in the node's Private Key (PEM) field. Every Logging action also needs a Compartment OCID for the compartment you are working in.

02Log

OCI Logging: Change Log Log Group

oracle/logging/log_change_log_group · Action

Move a log into a different log group — the log keeps its OCID, only its parent log group changes. Returns a work-request id.

Returns: tool_result, id, work_request_id, success, error

OCI Logging: Create Log

oracle/logging/log_create · Action

Create a custom or service log inside a log group. Returns a work-request id — poll until the log is ACTIVE.

Returns: tool_result, work_request_id, success, error

OCI Logging: Delete Log

oracle/logging/log_delete · Action

Delete a log from its log group by OCID — ingestion into it stops. Returns a work-request id tracking the removal.

Returns: tool_result, id, work_request_id, success, error

OCI Logging: Get Log

oracle/logging/log_get · Action

Fetch a single log by its OCID — its display name, type, enabled flag, retention and lifecycle state.

Returns: tool_result, log, id, lifecycle_state, success, error

OCI Logging: Change Log Group Compartment

oracle/logging/log_group_change_compartment · Action

Move a log group into a different compartment — the log group keeps its OCID, only its compartment placement changes.

Returns: tool_result, id, destination_compartment_id, success, error

OCI Logging: Create Log Group

oracle/logging/log_group_create · Action

Create a log group — the container that service and custom logs live in. Asynchronous: returns a work-request id and no body; poll the work request until it succeeds.

Returns: tool_result, work_request_id, success, error

OCI Logging: Delete Log Group

oracle/logging/log_group_delete · Action

Delete a Logging log group by its OCID. Returns a work-request id — the removal happens asynchronously.

Returns: tool_result, id, work_request_id, success, error

OCI Logging: Get Log Group

oracle/logging/log_group_get · Action

Fetch a single Logging log group by its OCID — its display name, compartment, lifecycle state and timestamps.

Returns: tool_result, log_group, id, lifecycle_state, success, error

OCI Logging: List Log Groups

oracle/logging/log_group_list · Action

List the log groups in a compartment. Optionally filter by exact display name. Walks pagination up to a safe cap.

Returns: tool_result, log_groups, count, truncated, success, error

OCI Logging: Update Log Group

oracle/logging/log_group_update · Action

Partially update a log group — change only the display name or description you supply; blank fields are left unchanged. Returns a work-request id to poll for completion.

Returns: tool_result, id, work_request_id, success, error

OCI Logging: List Logs

oracle/logging/log_list · Action

List the log objects in a log group. Optionally filter by log type (custom or service) or exact display name. Walks pagination up to a safe cap.

Returns: tool_result, logs, count, truncated, success, error

OCI Logging: Update Log

oracle/logging/log_update · Action

Partially update a log — change only the display name, enabled flag or retention duration you supply; blank fields are left unchanged. Returns a work-request id — poll Get Log until the change lands.

Returns: tool_result, work_request_id, id, success, error

03Search

OCI Logging: Search Logs

oracle/logging/search_logs · Action

Run a Logging Query Language search over stored log content for a time window, returning the matching log entries and their count.

Returns: tool_result, results, count, success, error

04Service

OCI Logging: List Services

oracle/logging/service_list · Action

List every OCI service that is integrated with public logging. Tenancy-wide, so no compartment is required.

Returns: tool_result, services, count, success, error

05Unified

OCI Logging: Delete Unified Agent Configuration

oracle/logging/unified_agent_config_delete · Action

Delete a unified monitoring agent configuration by its OCID. Returns a work-request id you can track to completion.

Returns: tool_result, id, work_request_id, success, error

OCI Logging: Get Unified Agent Configuration

oracle/logging/unified_agent_config_get · Action

Fetch a single unified monitoring agent configuration by its OCID — its enabled flag, lifecycle state and details.

Returns: tool_result, config, id, lifecycle_state, success, error

OCI Logging: List Unified Agent Configurations

oracle/logging/unified_agent_config_list · Action

List the unified monitoring agent configurations in a compartment. Optionally filter by exact display name. Walks pagination up to a safe cap.

Returns: tool_result, configs, count, truncated, success, error

06Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

• Creating, updating or deleting a log or log group, and moving a log into a different log group, run asynchronously and return a work-request id instead of the finished resource, so poll that work request (or the matching Get action) until the log or log group reaches its target lifecycle state before a later step relies on it.
• A log's retention must be a whole number of days in 30-day increments from 30 up to 180, and Oracle Cloud rejects any other value.
• List actions walk pagination only up to 25 pages, so a very large compartment or log group can return an incomplete set; narrow it with the available display-name or log-type filter rather than relying on one unfiltered list.
• Search Logs runs Oracle's Logging Query Language over stored content and returns only entries inside the required Start Time and End Time window (RFC3339, e.g. 2026-07-22T09:00:00Z), so an empty result often means the window or query needs adjusting rather than the log being empty.