Managing Remote Configurations

The Config Overview page provides information on the LogScale Collector configuration files you have created for remote centralized use, how they are being used, and details on all the enrolled instances of LogScale Collector.

This page also allows you to delete configuration files directly or create and edit files through the Config Editor.

Note that if you want to switch the configuration assigned to an enrolled instance see Switching Remote Configs.

  1. To access the Config Overview page go the Fleet Management tab.

  2. Click Config overview and the page is displayed.

Creating a Remote Configuration

You can create a new configuration from this page which can then be assigned to multiple LogScale Collector instances and managed centrally.

  1. Go to Config overview and click + New Config.

    Config Overview

    Figure 297. Config Overview


  2. Type the name for your new configuration and click either:

    • Create New - creates a new configuration from scratch

    • Create from template and browse for a previously exported or manually created configuration file (.yaml).

      Create New Configuration

      Figure 298. Create New Configuration


  3. The Config Editor is displayed, configure the file to meet your needs, note that you can only edit the sections: sources, sinks and settings, see Sources and Examples for more information.

    The editor helps by underlining incorrectly positioned entities (incorrect level) or misspelled and by autocompleting entities when you are inserting new entities, additionally you can hover-over entities for useful tips and information.

    Config Editor

    Figure 299. Config Editor


  4. Click the settings cog to view the Basic Settings to manage additional settings, like description and name and to assign instances to the configuration or manage a test draft, see Figure 306, “Basic information”for more information.

  5. Once you have finished making changes you can:

    • Click Save as draft to save the changes without publishing.

    • Click Start test to test your configuration file by publishing it to specific instances.

    • Click Publish draft to save the changes and publish them to all the instances which are using the configuration.

Editing a Remote Configuration

You can edit remote configuration and if they are assigned to multiple instances the changes will impact all of the instances of the LogScale Collector.

  1. Click the ellipsis menu next to the config you want to edit and click Edit config.

  2. Make the required changes, note that you can only edit the sections: sources, sinks and settings, see Sources and Examplesfor details on the file.

    Config Editor

    Figure 300. Config Editor


  3. Click the settings cog to view the Basic Settings to manage additional settings, like description and name and to assign instances to the configuration or manage a test draft, see Figure 306, “Basic information”for more information.

    • Settings

      Figure 301. Settings


  4. Once you have finished making changes click either:

    • Click Save as draft to save the changes without publishing.

    • Click Start test to test a draft on a set of instance which you can choose in the next step, see Figure 313, “Test status”

    • Click Publish config to save the changes and publish them to all the instances which are using the config.

Export Configuration Template

You can export a configuration as a template which can then be imported and modified as required from the create new pop-up, see Creating a Configuration - Fleet Management.

  1. Go to the Config overview page.

    Config Overview

    Figure 302. Config Overview


  2. Click the ellipsis menu next to the config you want to export and click Export as template.

  3. Select the a radio button to export either:

    • Published version

    • Draft version

    Export Pop-up

    Figure 303. Export Pop-up


    And click Export as template

  4. Browse for the location to save the file, specify a name for the file and click Save.

Deleting a Remote Configuration

You can delete a configuration from the Config overview page.

  1. Go to the Config overview page.

    Config Overview

    Figure 304. Config Overview


  2. Click the ellipsis menu next to the config you want to delete and click Delete config. Note that it is not possible to delete a configuration which is associated to any instances.

  3. Click Delete config to confirm.

    Delete Pop-up

    Figure 305. Delete Pop-up


Testing a Remote Configuration

When you edit a configuration you can test the configuration on one or more instances before publishing the configuration to its assigned instances, this is useful when you want to test the impact of your changes without impacting instances which are collecting data.

  1. Go the Fleet management and select Config overview.

  2. Click on the ellipsis menu next to the configuration you want to change and select Edit config.

  3. You can test any changes which have been saved as draft, to do so click Start test and select the instance to which you want to assign the draft configuration.

To view the status and add instances to the configuration test see Editing and Publishing a Test Configuration.