Oracle Cloud Infrastructure Documentation

Device Logging

Roving Edge device logs are collected and uploaded to your tenancy. The logs are used by Oracle to troubleshoot problems that might arise. You can disable uploading of logs to your tenancy, for example, when your device isn't connected to your OCI tenancy.

By default, Roving Edge device logs are collected and stored every five minutes in two local Object Storage buckets:

  • orei-logs – This bucket has application server logs, metrics logs, and OS logs.
  • orei-request-logs – This bucket has audit logs.

The logs provide useful information:

  • Records of user activity
  • Device activity
  • API metrics
  • Error messages

You can view the logs by downloading them from the local buckets. See Downloading an Object.

By default, four preconfigured Data Sync tasks run hourly to upload the logs from the local buckets into Object Storage buckets in your OCI tenancy. The four Data Sync tasks are identified by OCIDs, that are referred to as task definition IDs:

ocid1.datasynctaskdefinition.orei.orei-1.<uniqueID>
ocid1.datasynctaskdefinition.orei.orei-1.<uniqueID>
ocid1.datasynctaskdefinition.orei.orei-1.<uniqueID>
ocid1.datasynctaskdefinition.orei.orei-1.<uniqueID>

Disabling and Enabling Log Uploads

Prerequisite

The OCI CLI must be installed and configured to reach the Roving Edge device. See Using the Command Line Interface with a Roving Edge Infrastructure Device.

  1. Run the following command to disable log uploads.

    oci raw-request --http-method POST \
 --target-uri https://<device_hostname>:21060/20201030/taskDefinitions/<task_definition_id>/actions/changeState \
 --cert-bundle <device-cert-bundle.pem_filepath>  --config-file <oci-config_filepath> --profile <profile_name> \
 --request-body '{"isEnabled": <true|false>}'

    Replace the following placeholders:

    • <device_hostname>: The hostname of the device.

    • <task_definition_id>: Specify one of the four predefined OCIDs. See Getting a Data Sync Task's Details for Roving Edge Infrastructure.

    • <device-cert-bundle.pem_filepath>: The file path to the CA bundle file.

    • <oci-config_filepath>: The file path to the CLI config file.

    • <profile_name>: The CLI profile that's configured to reach the device.

    • <true|false>: Enter false to disable log uploads. Enter true to enable log uploads.

    Example output of a successful command:

    {
  "data": "",
  "headers": {
    "Date": "Tue, 18 Jun 2024 03:59:00 GMT",
    "opc-request-id": "<unique_ID>"
  },
  "status": "204 No Content"
}
  2. Repeat this procedure for the remaining three task definition IDs.