help.sumologic.com

Good News! We have now officially released a REST API for upgrading, or downgrading, your installed Sumo Logic Collector Agents. This is available to all customers, in all regions. The API allows you to list the available Collector versions, initiate an asynchronous upgrade on a specific Collector agent, and check the status of the initiated upgrades. The documentation for the API can be found here: https://help.sumologic.com/APIs/01Collector_Management_API/Upgrade_or_Downgrade_Collectors_Using_the_API In addition, we have released a Collector Management API Client, written in Python, that can be used directly, or used as a reference for building your own Collector Management Client in the language of your choice. This Collector Management Client can be found on Sumo Logic's GitHub at: https://github.com/SumoLogic/collector-management-client . The complete instructions are in the associated ReadMe file. This client, and the API, were specifically developed to help with the management of large scale Collector installs. With this API client, you can optionally define subsets of your Collector install base, and upgrade Collectors and Sources automatically in smaller, user-defined batches. This allows you to initiate a single upgrade process without overtaxing your data centers bandwidth with too many parallel Collector Agent downloads. You can define subsets of collectors by specifying filters based on Collector Names and Source Categories. From there, you can specify the size of the batch for concurrent upgrades. The progress of the Collector upgrades within the batch are periodically polled, and their progress is written to the console in a tabular format. Once a batch is complete, the script will proceed to the subsequent batch. In addition to upgrading Collectors, the script can also be used to add or modify Collector Sources. It comes with a predefined template for adding our new Host Metrics Source to your defined set of Collectors, but the Source template can be modified to add any Source. This new Host Metrics Source allows you to collect about 50 different performance statistics for each of your hosts, and integrates that data with Sumo Logic's new Unified Logs and Metrics platform. Details on the Host Metrics Source can be found at : https://help.sumologic.com/Metrics/Metrics_Sources/01Host_Metrics_Source_for_Installed_Collectors . As an additional note, we are actively working on an improved UI and workflow for upgrading Collectors and Sources using the UI. And, Of course, if you already have a scripted approach for pushing out Collector and Source upgrades, you may continue to use that as well. Take a look, give it a spin, and let us know your thoughts! Brian Goleno Sumo Logic Product Management, Data Collection and Ingest