Managing Plugins with Oracle Cloud Agent

Oracle Cloud Agent is a lightweight process that manages plugins running on compute instances. Plugins collect performance metrics, install OS updates, and perform other instance management tasks.

To use plugins on an instance, the Oracle Cloud Agent software must be installed on the instance, the plugins must be enabled, and the plugins must be running. You might need to perform additional configuration tasks before you can use certain plugins.

Supported Images

Oracle Cloud Agent: Oracle Cloud Agent is supported on current platform images and on custom images that are based on current platform images. Oracle Cloud Agent is installed by default on current platform images.

If you use an older platform image, you must manually install the Oracle Cloud Agent software. Select an image dated after November 15, 2018 (except Ubuntu, which must be dated after February 28, 2019).

You might have success manually installing Oracle Cloud Agent on other images, though it has not been tested on other operating systems and there is no guarantee that it will work.

Plugins: Plugins are installed as part of Oracle Cloud Agent. The plugins that are supported for an instance depend on the version of Oracle Cloud Agent and on the image that you use to create the instance. To determine which plugins are supported for a particular image, use the Console to create an instance. Or, use the ListInstanceagentAvailablePlugins API operation, providing the OS name and OS version of the image.

Note

On Arm-based Ampere A1 Compute shapes, the Custom Logs Monitoring plugin is not supported.

Available Plugins

Each Oracle Cloud Agent plugin provides functionality related to compute instances. This functionality can enable features that are part of the Compute service, and features that are part of other services.

The following Oracle Cloud Agent plugins are available.

Plugin Name Description Steps to Configure and Use
Bastion Allows secure shell (SSH) connections to an instance without public IP addresses using the Bastion service. See Bastion.
Compute Instance Monitoring Emits metrics about the instance's health, capacity, and performance. These metrics are consumed by the Monitoring service. See Enabling Monitoring for Compute Instances and Compute Instance Metrics.
Compute Instance Run Command Runs scripts within the instance to remotely configure, manage, and troubleshoot the instance. See Running Commands on an Instance.
Custom Logs Monitoring Ingests custom logs into the Logging service. See Custom Logs.
Management Agent Collects data from resources such as OSs, applications, and infrastructure resources for Oracle Cloud Infrastructure services that are integrated with Management Agent. Data can include observability, log, configuration, capacity, and health data. See Deploy Management Agents on Compute Instances.
Oracle Autonomous Linux Manages autonomous updates and collects data associated with events, including logs and stack traces, for instances managed by the Autonomous Linux service. See Oracle Autonomous Linux
OS Management Service Agent Manages updates and patches for the operating system environment on the instance. See OS Management.
Vulnerability Scanning Scans the instance for potential security vulnerabilities like OS packages that require updates. See Scanning Overview.
Block Volume Management Configures Block Volume sessions for the instance. See Enabling the Block Volume Management Plugin and Attaching to Ultra High Performance Volumes.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

For administrators: The policy in Let users launch compute instances includes the ability to enable and disable individual plugins, as well as start and stop all plugins on an instance. If the specified group doesn't need to launch instances or attach volumes, you could simplify that policy to include only manage instance-family, and remove the statements involving volume-family and virtual-network-family. In addition, you must use the following policy to allow users to access the available plugins:

Allow group PluginUsers to read instance-agent-plugins in compartment ABC
If you're new to policies, see Getting Started with Policies and Common Policies. For reference material about writing policies for instances, cloud networks, or other Core Services API resources, see Details for the Core Services.

Installing the Oracle Cloud Agent Software

Note

If you create an instance using a current platform image or a custom image that's based on a current platform image, then Oracle Cloud Agent is installed by default. No action is needed.

If you want to manually install the Oracle Cloud Agent software on an instance that uses another supported image, use the following steps.

To manually install Oracle Cloud Agent on a Linux instance
  1. Connect to the instance.
  2. To download the Oracle Cloud Agent software, run one of the following scripts.

    Oracle Linux
    1. To determine whether the Oracle Cloud Agent software is installed, run one of the following commands. On Oracle Linux:

      sudo yum info oracle-cloud-agent

      On Oracle Linux Cloud Developer:

      rpm -qa | grep oracle-cloud-agent

      The command returns the Oracle Cloud Agent version that is currently installed.

    2. If Oracle Cloud Agent isn't installed, or if the installed version is not the latest version, install the latest version by running the following command:

      sudo yum install -y oracle-cloud-agent
      Note

      If you don't have access to the yum repository that has Oracle Cloud Agent, run one of the following scripts.

      Oracle Linux 6.x
      #!/bin/sh
      cd ~
      curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/pk4N48VYxPMExfKPRe_sIKf-yL1UPECeNhb3PWrTLpBfcEpFvo39w5CHtO74u8zY/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6006.el6.x86_64.rpm -v
      Oracle Autonomous Linux 7.x, Oracle Linux 7.x

      For Intel and AMD shapes (x86 processors):

      #!/bin/sh
      cd ~
      curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/GwzrmGuX5QIpV3alj5ndt-zXGvwSgPm9fYsk1W3kiYxMZlvLv1AnNRTboCFvdQkg/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v

      For Arm-based shapes (aarch64 processors):

      #!/bin/sh
      cd ~
      curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/QW-4U80C0_pUbcxmueAhC3pnWgVikC-w6GoE3AWdDMr_HowxFMfUzSLeiDoI5fL-/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-4.el7.aarch64.rpm -v
      Oracle Linux 8.x, Oracle Linux Cloud Developer 8.x

      For Intel and AMD shapes (x86 processors):

      #!/bin/sh
      cd ~
      curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/PlOj2Z-w2V-jtv_azf8zuMPNCU8OB5By8n9148ttMrm5rYqhKXzCwCb-5NA-z6Uf/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el8.x86_64.rpm -v

      For Arm-based shapes (aarch64 processors):

      #!/bin/sh
      cd ~
      curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/wkqzg-ePLvEq6ikyN97dC4poSuvNwiUVg_9Xhw8kiWsdZ78bXPCazvSLqBt9wjdS/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-4.el8.aarch64.rpm -v
    CentOS 7.x
    #!/bin/sh
    cd ~
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/GwzrmGuX5QIpV3alj5ndt-zXGvwSgPm9fYsk1W3kiYxMZlvLv1AnNRTboCFvdQkg/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v
    CentOS 8.x
    #!/bin/sh
    cd ~
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/PlOj2Z-w2V-jtv_azf8zuMPNCU8OB5By8n9148ttMrm5rYqhKXzCwCb-5NA-z6Uf/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el8.x86_64.rpm -v
    Ubuntu 18.04 and Ubuntu 20.04
    Note

    To install Oracle Cloud Agent on instances that use Ubuntu images, Snapcraft must be installed on the instance. Install Snapcraft by running the following commands, in sequence:

    sudo apt update
    sudo apt install snapd
    sudo snap install oracle-cloud-agent --classic

    This command installs and runs the Oracle Cloud Agent software.

  3. To run the Oracle Cloud Agent software on the instance, enter one of the following commands.

    Oracle Linux
    sudo yum install -y <instance-agent-filename>
    CentOS
    sudo yum install -y <instance-agent-filename>
    Ubuntu

    No further action is needed. The command in the previous step installs and runs the software.

To manually install Oracle Cloud Agent on a Windows instance
  1. Connect to the instance.
  2. Download the Oracle Cloud Agent software from the following URL:

    https://objectstorage.us-phoenix-1.oraclecloud.com/p/4MiveuH7KsszEUQaKkXhTDGIVdpY5j0qL5imeR18QMHpGrjPNK8HypiIDauMvpHD/n/imagegen/b/agents/o/OracleCloudAgentSetup_v1.17.2.msi

  3. As a user with administrative privileges, enter the following command to run the Oracle Cloud Agent software on the instance.
    msiexec /qb /i <instance-agent-filename>
To install Oracle Cloud Agent using cloud-init when creating an instance

If you want to install Oracle Cloud Agent on an instance that uses an older image as part of the instance launch, you can provide a cloud-init script (cloudbase-init on Windows instances) when you create the instance.

  1. Follow the steps to create an instance, until the advanced options.
  2. Click Show Advanced Options.
  3. On the Management tab, in the Initialization Script section, select Paste cloud-init script. Then, copy and paste one of the following scripts, depending on the image.

    Oracle Linux
    sudo yum install -y oracle-cloud-agent
    Note

    If you don't have access to the yum repository that has Oracle Cloud Agent, copy and paste one of the following scripts.

    Oracle Linux 6.x
    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/pk4N48VYxPMExfKPRe_sIKf-yL1UPECeNhb3PWrTLpBfcEpFvo39w5CHtO74u8zY/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6006.el6.x86_64.rpm
    yum install -y ~/oracle-cloud-agent-1.17.0-6006.el6.x86_64.rpm -v
    Oracle Linux 7.x

    For Intel and AMD shapes (x86 processors):

    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/GwzrmGuX5QIpV3alj5ndt-zXGvwSgPm9fYsk1W3kiYxMZlvLv1AnNRTboCFvdQkg/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v

    For Arm-based shapes (aarch64 processors):

    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/QW-4U80C0_pUbcxmueAhC3pnWgVikC-w6GoE3AWdDMr_HowxFMfUzSLeiDoI5fL-/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-4.el7.aarch64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-4.el7.aarch64.rpm -v
    Oracle Linux 8.x, Oracle Linux Cloud Developer 8.x

    For Intel and AMD shapes (x86 processors):

    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/PlOj2Z-w2V-jtv_azf8zuMPNCU8OB5By8n9148ttMrm5rYqhKXzCwCb-5NA-z6Uf/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el8.x86_64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-6126.el8.x86_64.rpm -v

    For Arm-based shapes (aarch64 processors):

    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/wkqzg-ePLvEq6ikyN97dC4poSuvNwiUVg_9Xhw8kiWsdZ78bXPCazvSLqBt9wjdS/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-4.el8.aarch64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-4.el8.aarch64.rpm -v
    CentOS 7.x
    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/GwzrmGuX5QIpV3alj5ndt-zXGvwSgPm9fYsk1W3kiYxMZlvLv1AnNRTboCFvdQkg/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v
    CentOS 8.x
    #!/bin/sh
    curl -O https://objectstorage.us-phoenix-1.oraclecloud.com/p/PlOj2Z-w2V-jtv_azf8zuMPNCU8OB5By8n9148ttMrm5rYqhKXzCwCb-5NA-z6Uf/n/imagegen/b/agents/o/oracle-cloud-agent-1.17.0-6126.el7.x86_64.rpm -v
    yum install -y ~/oracle-cloud-agent-1.17.0-6126.el8.x86_64.rpm -v
    Ubuntu 18.04 and Ubuntu 20.04
    Note

    To install Oracle Cloud Agent on instances that use Ubuntu images, Snapcraft must be installed on the instance. Install Snapcraft by running the following commands, in sequence:

    sudo apt update
    sudo apt install snapd
    sudo snap install oracle-cloud-agent --classic
    Windows Server 2012 R2, Windows Server 2016, and Windows Server 2019
    Note

    For legacy versions of Windows images, ensure that cloudbase-init is supported. See WinRM and cloudbase-init on Windows images.
    #ps1_sysnative
    cd \Users\opc\Desktop
    Start-BitsTransfer -Source "https://objectstorage.us-phoenix-1.oraclecloud.com/p/4MiveuH7KsszEUQaKkXhTDGIVdpY5j0qL5imeR18QMHpGrjPNK8HypiIDauMvpHD/n/imagegen/b/agents/o/OracleCloudAgentSetup_v1.17.2.msi" -Destination "c:\Users\opc\Desktop\OracleCloudAgentSetup.msi"
    msiexec /i "c:\Users\opc\Desktop\OracleCloudAgentSetup.msi" /quiet /L*V "c:\Users\opc\Desktop\OracleCloudAgentSetup.log" 
  4. Click Create.

Managing Plugins Using the Console

To see which plugins are enabled for an instance
  1. Open the navigation menu and click Compute. Under Compute, click Instances.
  2. Click the instance that you're interested in.
  3. Click the Oracle Cloud Agent tab.

    The list of plugins is displayed. Enabled plugins can have the following statuses:

    • RUNNING: The plugin is running.
    • STOPPED: The plugin is stopped.
    • NOT_SUPPORTED: The plugin is not supported on this platform.
    • INVALID: The plugin status is not recognizable by the service.
To enable or disable a plugin
  1. Open the navigation menu and click Compute. Under Compute, click Instances.
  2. Click the instance that you're interested in.
  3. Click the Oracle Cloud Agent tab.
  4. Toggle the Enabled or Disabled switch for the plugin.

    Caution

    Functionality that depends on the plugin, such as monitoring, autoscaling, or OS management, will not work when the plugin is disabled.

    It takes up to 10 minutes for the change to take effect.

  5. If you enabled a plugin, if necessary, perform any configuration tasks that are required before you can use the plugin. For information about how to configure each plugin, see the documentation for each plugin in Available Plugins.
To stop all plugins on an instance

You can stop all of the plugins that are running on an instance. Any individual plugins that are enabled on the instance remain enabled, but the plugin processes stop running. The plugin processes will only start running again after you restart all plugins.

For example, if you want to troubleshoot plugins, you can stop all plugins and then disable the plugins that you think might have an error. Reenable the plugins one-by-one, restarting the plugins after you enable each plugin, to determine which plugin has an issue. For more information about troubleshooting plugins, see Step 4: Generate a Diagnostic File for Oracle Cloud Agent.

To stop all plugins on an instance:

  1. Open the navigation menu and click Compute. Under Compute, click Instances.
  2. Click the instance that you're interested in.
  3. Click the Oracle Cloud Agent tab.
  4. Click Stop Plugins.

    Caution

    Functionality that depends on plugins, such as monitoring, autoscaling, and OS management, will not work when all plugins are stopped.
  5. Click Stop Plugins.

    It might take several minutes for all plugins to stop. Oracle Cloud Agent continues to run when plugins are stopped.

To start all plugins on an instance
  1. Open the navigation menu and click Compute. Under Compute, click Instances.
  2. Click the instance that you're interested in.
  3. Click the Oracle Cloud Agent tab.
  4. Click Start Plugins.

    It takes up to 10 minutes for the plugins to restart.

Managing Plugins Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use these API operations to manage Oracle Cloud Agent plugins:

  • In the Core Services API:

    • LaunchInstance - enables or disables plugins, or stops all plugins, when you create an instance.
    • GetInstance and ListInstances - gets information about which plugins are enabled on an instance (or a list of instances).
    • UpdateInstance - enables or disables individual plugins, and stops or starts all plugins, for an existing instance.
  • In the Oracle Cloud Agent API:

    • ListInstanceagentAvailablePlugins - lists the plugins that are available for all instances. You can filter the results based on the image that you plan to use to launch an instance.
    • ListInstanceAgentPlugins - gets information about the plugins that are available on an existing compute instance.
    • GetInstanceAgentPlugin - gets information about a specific plugin on an existing compute instance.

Updating the Oracle Cloud Agent Software

We recommend always running the latest version of the Oracle Cloud Agent software.

If the instance can access the internet, then no action is needed. Oracle Cloud Agent periodically checks for newer versions and installs the latest version when an update is available.

Note

Oracle Cloud Agent version 1.11.0 does not update itself automatically. See this known issue for more information.

If the instance does not have access to the internet, then you must manually update the Oracle Cloud Agent software. For example, a compute instance cannot access the internet if it does not have a public IP address, internet gateway, or service gateway. In this situation, Oracle Cloud Agent cannot complete its checks for newer versions.

To see which version of Oracle Cloud Agent is installed

Connect to the instance and then do one of the following things:

  • For Oracle Linux and CentOS, run the following command:

    sudo yum info oracle-cloud-agent
  • For Oracle Linux Cloud Developer, run the following command:

    rpm -qa | grep oracle-cloud-agent
  • For Ubuntu, run the following command:

    snap info oracle-cloud-agent
  • For Windows, do one of the following things:
    • In Control Panel, select Programs and Features and then find the version number provided for "Oracle Cloud Agent."
    • In PowerShell, run the following command:

      Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -eq "Oracle Cloud Agent" }

      Example output:

      IdentifyingNumber : {exampleuniqueidentifer}
      Name              : Oracle Cloud Agent
      Vendor            : Oracle Corporation
      Version           : 0.0.10.0
      Caption           : Oracle Cloud Agent
To manually update Oracle Cloud Agent on a compute instance

Do one of the following things:

  • Temporarily allow the instance to access the internet so that Oracle Cloud Agent can update itself.
  • Redo the installation steps, using the latest version.

Oracle Cloud Agent Release Notes

Linux versions
Version Date Changes
1.17.0 November 19, 2021

The Oracle Cloud Agent version now adheres to the Semantic Versioning Specification (semver).

When the monitoring client fails to construct during start, the gomon command-line utility is now able to recover.

Oracle Autonomous Linux:

  • Adds fixes to ignore false alarms.
  • Reduces startup time.
  • Adds a health check.
1.16.0 October 20, 2021

OS Management Service Agent:

  • Adds support for Oracle Linux 8.x.
  • Adds support for cleaning up data storage for inactive native agents.

Oracle Autonomous Linux:

  • Adds support for custom configurations.
  • Removes soscleaner and Oracle Ksplice sudo access to master.

Compute Instance Run Command:

  • Fixes an environment variable bug.

Changes the ownership of the agent.yml configuration file to support upgrades.

1.15.0 September 21, 2021 Adds support for the OS Management Service Agent plugin with Arm-based shapes running Oracle Linux.
1.14.2 September 2, 2021 Adds support for the Oracle Autonomous Linux plugin.
1.14.0 August 20, 2021

The diagnostic tool is now included in the release package.

OS Management Service Agent:

  • Adds support for automatically enabling the resource discovery and monitoring feature with a new policy.
1.13.0 July 1, 2021

Adds support for Arm-based shapes running Oracle Linux for the following plugins:

  • Bastion
  • Block Volume Management
  • Compute Instance Run Command
  • Vulnerability Scanning

Delays the update check on startup by one hour.

Moves the instance agent service endpoint from iaas to instance-agent.

OS Management Service Agent:

  • Adds support for custom CA certificates.

Vulnerability Scanning:

  • Updates the way RPM packages are queried.
1.12.0 June 2, 2021

Bastion:

  • Fix to only create the control plane and data plane clients once and not on each iteration of the bastion workflow.

Block Volume Management:

  • Updated the plugin status to be running or stopped when it is running or stopped respectively.
  • Removed the default /etc/multipath.conf to avoid conflicts.
  • Improved the error message to report no volume attachments were found by the plugin.
  • Fixed a race condition by restarting the multipathd service.

Ubuntu instances only:

  • Miscellaneous updates.
1.11.4 May 20, 2021 Fixes an issue with the updater not updating the Oracle Cloud Agent software. See this known issue.
1.11.3 May 14, 2021 Miscellaneous updates.
1.11.1 May 3, 2021

Replaces the Python updater with a Golang updater.

Initial release of the Bastion plugin.

1.10.0 April 7, 2021

Custom Logs Monitoring:

  • Added support for Ubuntu 16.04, 18.04, and 20.04.

OS Management Service Agent:

  • Added osmsx_ctl to manage a flag file in future Autonomous Linux releases.
  • Added FIPS Object Model to the OS Management Service Agent build.

Ubuntu instances only:

  • Added support for Custom Logs Monitoring.
1.9.0 March 3, 2021

OS Management Service Agent:

  • OS Management process binds to port in ephemeral range.
  • Custom error handler for empty yum transactions.
1.8.3 January 13, 2021

Ubuntu instances only:

  • Adds support to enable or disable individual plugins.
  • Adds two new metrics for monitoring.
  • Fix for updater start in new images.
  • Updater fix for signature verification on packages.
  • Adds support for reattachable plugins so that Oracle Cloud Agent can be upgraded without stopping plugins.
1.8.2 January 13, 2021

Compute Instance Monitoring:

  • Improve filtering of UNIX disk devices.
1.8.1 January 13, 2021

OS Management Service Agent:

  • Disabled by default.
1.8.0 January 13, 2021

Adds support to enable or disable individual plugins.

Adds two new metrics for monitoring.

OS Management Service Agent:

  • Enabled by default.
1.7.1 December 17, 2020

Fix for updater start in new images.

OS Management Service Agent disabled in US Government Cloud.

1.7.0 December 7, 2020

Updater fix for signature verification on packages.

Custom Logs Monitoring:

  • Bug fix for signature verification.
  • Add default bucket namespace for non-commercial realms.
1.6.0 November 6, 2020

Adds support for reattachable plugins so that Oracle Cloud Agent can be upgraded without stopping plugins.

Compute Instance Run Command:

  • Includes support for the run command feature in all regions in the Oracle Cloud Infrastructure commercial realm.

Custom Logs Monitoring:

  • Enables package signature verification in CentOS.

OS Management Service Agent:

  • Fixes the plugin to stop its process when it is requested to stop rather than staying up idle.
  • Fixes an upgrade kill cycle bug where OS Management upgrades Oracle Cloud Agent using yum, which then stops Oracle Cloud Agent, which stops the plugin.
1.5.1 October 27, 2020 Includes support for the run command feature.
1.4.1 October 21, 2020 Hotfix for agent termination of orphaned processes.
1.4.0 October 2, 2020

Fixes in updater daemon and plugins to make them more resilient.

1.3.2 September 9, 2020

Fix auto update download directory permissions.

Minor enhancements to the Compute Instance Monitoring plugin. Enable additional plugins.

Create grpc sockets in /var/lib/oracle-cloud-agent/tmp.

1.2.0 August 3, 2020 Upgrade the agent to support plugins
0.0.19 May 28, 2020

Fix updater failing to run on images that mount a filesystem with noexec flag set, to /tmp.

Use instance metadata to generate client side URLs.

Includes support for the instance metadata service (IMDS) v2.

0.0.18 May 11, 2020 Miscellaneous updates.
0.0.15 January 15, 2020 Migrate from Python 2.7.15 to Python 3.6.9.
0.0.13 November 4, 2019 Fix a bug in handling monitoring service internal server errors.
0.0.11 September 13, 2019 Fix retry strategy for sending metrics and refresh security tokens.
0.0.10 July 15, 2019 Fix for correct handling of forced termination of the oracle-cloud-agent-updater.
Windows versions
Version Date Changes
1.17.2 November 19, 2021

Fixes an OS Management Service Agent time-out bug.

1.17.0 November 19, 2021

The Oracle Cloud Agent version now adheres to the Semantic Versioning Specification (semver).

When the monitoring client fails to construct during start, the gomon command-line utility is now able to recover.

1.16.0 October 20, 2021

Adds all Windows Server 2019 users to the diagnostic tool.

Fixes to the diagnostic tool.

1.15.0 September 21, 2021 Bug fixes.
1.14.0 August 20, 2021

The diagnostic tool is now included in the release package.

Added support for the OS Management Service Agent self-test.

1.13.0 July 1, 2021

Delays the update check on startup by one hour.

Moves the instance agent service endpoint from iaas to instance-agent.

OS Management Service Agent:

  • Adds support for custom CA certificates.
1.12.0 June 2, 2021

Block Volume Management:

  • Bug fixes.

Custom Logs Monitoring:

  • Use OS version fall back for Windows OS.

Vulnerability Scanning:

  • Bug fixes.
1.11.1 May 20, 2021 Fixes an issue with the updater not updating the Oracle Cloud Agent software. See this known issue.
1.11.0 May 3, 2021 Replaces the Python updater with a Golang updater.
1.10.0 April 7, 2021

Closes open handle for allocstall metric.

OS Management Service Agent:

  • Additional logging on Windows.
  • Adds osmsx_ctl.
1.9.0 March 3, 2021 Bug fixes.
1.8.0 January 13, 2021

Adds support to enable or disable individual plugins.

Adds two new metrics for monitoring.

OS Management Service Agent:

  • Enabled by default.
1.7.1 December 17, 2020 All plugins disabled in US Government Cloud.
1.7.0 December 7, 2020

Updater fix for signature verification on packages.

Compute Instance Run Command:

  • Enabled for Windows.

Custom Logs Monitoring:

  • Add default bucket namespace for non-commercial realms.

OS Management Service Agent:

  • Clean up leftover OS Management temporary directories due to OS Management being terminated on system reboot.
1.5.0.0 November 6, 2020

Adds support for reattachable plugins so that Oracle Cloud Agent can be upgraded without stopping plugins.

Custom Logs Monitoring plugin enabled in US Government Cloud realms.

1.4.1.0 October 2, 2020

Fixes in updater daemon and plugins to make them more resilient.

1.3.0.0 August 7, 2020 Minor enhancements to the Compute Instance Monitoring plugin.
1.2.0.0 June 26, 2020 Miscellaneous updates.
1.0.0.0 April 28, 2020

Includes all Microsoft patches as of April 24, 2020.

Includes a new version of the Oracle Cloud Agent with a plugin for Windows for the OS Management service.

Includes support for the instance metadata service (IMDS) v2.

0.0.13.0 January 15, 2020 Fixed: Migrate from Python 2.7.15 to Python 3.6.9.
0.0.11.0 November 5, 2019 Fixed: Fix a bug in handling monitoring service internal server errors.
0.0.10.0 September 13, 2019

Fixed:

  • Fix retry strategy for sending metrics and refresh security tokens
  • Fix for correct handling of forced termination of the oracle-cloud-agent-update
0.0.9.0 June 6, 2019 Fixed: Bug fix where agent restarts when telemetry or auth service returns 5xx.