Installing and Updating Packages

There are three ways to install a package:

  • Go to the Marketplace under the Settings tab in your view, search for a package and click Install

  • Go to installed packages under the Settings tab and click Upload and choose a package zip file from your local machine

  • Use Humio’s CLI to install the packages from a directory or a zip file located on your local machine.

Once you have installed a package, it will appear under the Packages ‣ Installed section of the Settings tab.

If you installed a library, you will now be able to navigate to dashboards, saved queries, alerts and parsers and from there create a new component based on a template from that library.

If you installed an application you will also be able to create new components based on the components within the application in the same way as when you install a library.

When using a component, you will find a grouping in the lists of components with the name of the application and under that you will find these managed components. Application components are freely customizable, including deleting parts not required. However, care should be taken as deleting components may implications when updating the package.

Updating Packages

When a package update is available in the Marketplace it will be shown next to the installed package in the list of available packages, as well as on the individual installed package view.

To update click Update, this will take you through the update process. You be shown which components have been added, changed, and removed alongside the components that remain unchanged.

In the case of libraries, the component templates from the package are updated. Templates that have been modified from the original package remain unchanged.

For applications, where component templates are materialized during installation and afterwards managed by Humio, you may encounter conflicts during the upgrade process. Conflicts arise when you have made local changes to an application component prior to updating it. For example, if you installed an application with a dashboard and you’ve changed a widget of that dashboard, a conflict may occur when you update that application. In order to resolve conflict while updating an application Humio supports a basic Use Ours/Theirs merging view that lets you choose what to do with each conflicting component, meaning you either keep the modified version or replace it completely with the new version.

If you are using the Humio CLI you are able to entirely overwrite the installed package without handling update conflicts.