Creating Repositories

Figure 1, Repositories & Views

A repository in Humio is where you will store server logs and metrics. This is where you will be able to search and monitor your data in a much more comprehensive way. The ability to create repositories is available in Humio when running it locally, on-premise. This ability is different for Humio Cloud accounts.

When using a Trial account on Humio Cloud, you will be able to create one repository aside from the Sandbox that comes with every new trial organization. Paid Cloud accounts are entitled to multiple repositories, but are required to contact Humio Support to request their creation.

Some Humio Cloud customers currently have the ability to create their own repositories themselves. For information about accessing this feature, please contact Humio Support.

The guidance on this page applies to on-premise users, Humio Cloud Trial users, and a select few beta Humio Cloud accounts.

Create a Repository

Figure 2, Add a View or Repository

To start, log into Humio through the Humio User Interface. The opening screen will put you where respositories are listed. It will look similar to the one shown in Figure 1 here. Click on this image or any other one on this page to enlarge it.

To create a repository, click on the +Add Item icon. That will show a screen similar to the one in Figure 2 here. Notice that you have the choice of creating a View or a Repository. We’ll stick with creating a repository — views are covered on the Views documentation page. If your account is new and a trial one, it’ll offer to let you create a temporary repository.

Figure 3, New Repository

Choose Repository (or Trial Repository) to create a repository. This will lead to another screen that will ask you to name and describe the repository, like the one in Figure 3 here. As you can see, if you clicked on the image to enlarge it, we chose to name it Prognosticator for this example. When you’re finished, you would click +Create Repository.

Repository Settings

Figure 4, Repository Settings

After creating a repository, you will be taken to a page in which you can set some basic information about the repository. You’ll also be able to get an encryption token for your server to use to send data to the repository. This is all covered on the User Interface Settings page of this section of the Humio Documentation. As for getting data into the repository, you will need to set up data shippers on your server. That’s outside the User Interface, so it’s covered in the Ingest Data and Data Shippers sections of the documentation.

Data Retention

Figure 5, Data Retention

As mentioned above, some Humio Cloud accounts now have the ability to create their own repositories (see Figure 5). Retention must be set within the bounds of the contracted retention period. By design in Cloud, you cannot set retention to greater than 365 days. While you can change this value yourself, be aware that if you reduce the number, older data will be deleted.

Figure 6, Organization Statistics

Setting a long retention time means more usage of storage, and may affect the amount you’re charged for Humio Cloud services.

Next Steps

After you create a repository, you’ll have to set up data shippers on your server to send data to Humio to be stored in the repository. Look over the list of tasks on the first page of this section on Repositories.