Creating Repositories

Figure 1, Repositories & Views

A repository in Humio is where you’ll store server logs and metrics. This is where you’ll be able to search and monitor your data in a much more comprehensive way.

When using a Trial account on Humio Cloud, you will be able to create one repository—besides 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.

Create a Repository

To start, log into the Humio User Interface. The opening screen will put you where repositories 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.

Figure 2, Add a View or Repository

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

When you first finish 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 log shippers on your server. That’s outside the User Interface, so it’s covered in the Ingest Data and Log 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, 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 log 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.