Package File Formats

Humio packages are Zip files containing assets files (e.g. dashboards and alerts) a readme file, and a manifest.yaml file.

The file structures of a typical package would look something like this:

mypackage.zip
├── manifest.yaml
├── README.md
├── dashboards/
│   ├── dashboard-template-1.md
│   └── dashboard-template-2.md
├── alerts/
│   ├── alert-template-1.md
│   └── alert-template-2.md
├── queries/
│   ├── query-1.csv
│   └── query-2.json
...

Below is a description of each file (or file type) as well as a link to the JSON schema defining the file format.

Getting Started

We recommend you use Humio’s “export package” feature to get started with creating your own packages. To export a file, visit the “Settings” tab in the UI and under “Packages” click “Create my own package”. Fill out the form and examine the content of the zip file. It can be a good idea to check your package into source control and maintain it from there, rather than maintain everything in Humio and export every time

Understanding Package Scopes

As part of the export process youref will be asked to input “scope”. In Humio’s package system, a scope is essentially a namespace that allows multiple parties to create a package with the same name while avoiding naming collisions. If for instance you create a packages called accesslog-parsers it would be namespaced under your registry scope (essentially username), allowing for packages to be named:

`tomcat/accesslog-parsers`
`nginx/accesslog-parsers`
`dilbert/accesslog-parsers`

File Formats

The rest of this page describes the respective files that are part of a package. Most files are written in YAML and are best described by example. We also provide a JSON schema for each file (Json Scheme works YAML as well), you can find the schemas further down this page.

manifest.yaml

The manifest.yaml contains meta information about the package itself, such as author, license, description, and other meta tags. If you are familiar with NodeJS, this file can be compared to the package.json in the NPM package system.

Example:

$schema: https://schemas.humio.com/manifest/v2.0.0

name: nginx/nginx # <scope>/<name>

description: |
    This is a brief desciption of the package. One or two lines.

author:
  name: Thomas Anagrius
  email: thomas@humio.com

logoUrl: data:image/png;base64,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

contributors:
  - Peter Johnson <john@example.com>
  - John Doe <john@example.com>

The logoUrl should be a base64 encoded version of the logo for the package (usually technology logo).

README.md

Each package must provide a README.md file in the root directory. You can write it in markdown format and as a minimum it should contain information about what the package does and how you are expected to use it.

If your package is a collection of template files for a specific technology, a short description is usually enough.

README files for Apps

If your package is an application, it should also explain:

  • Any additional pre- or post-installation steps users need to take.
  • A general introduction about how to get started, e.g. including configuration files.

README file restrictions

The readme cannot currently contain images or HTML tags. We plan on easing this restriction to allow images that have been vetted by Humio and hosted on servers hosted by Humio.

Asset Files (Alerts, Dashboards, etc)

The best way to get started with asset files is to export assert you have authored in Humio and tweak them in a text editor.

Each file contains a $schema field which references the JSON schema that it is validated against.

Schemas

All schemas are hosted at: https://schemas.humio.com/

Pro Tip: Many editors have support for Json Schemas and will give you suggestions and and validate the files on the fly. One such editor is Visual Studio Code.

Lookup Files

BETA Support Only

Lookup files (files used with e.g. the match function) can also be included in packages. These can be useful when you want to replace ids with human readable names or enrich the data in other ways.

Generally it is recommended that things like IP databases or similar large dataset are NOT included in packages, but you instead describe how to provide the file by other means, e.g. using a cronjob and using Humio’s API to periodically update the file.