When data is sent to Humio it will stored in a repository. This is how Humio organizes data and calls a collection of data. It’s a container for data with associated storage. Often there will be one physical repository per project or system. However, this may vary based on the data volume, user permissions and many other factors.
Within Humio, each repository has its own set of users, dashboards, saved queries, and parsers. In a repository, you can control data retention and create parsers to distinguish incoming data. Some of these steps and components are covered in this section of the Humio Documentation — some are covered in other sections.
When you first log into the Humio User Interface, you’ll see an opening page similar to the one shown in Figure 1 here. Click on it or any other image on this page to enlarge it.
Notice it shows a list of repositories — this account doesn’t have any views. To search the data contained in a repository, you would click on it’s name (e.g., Testeroo in the screenshot here). When you do, it will take you to the Search page. This is covered in the Search page of this section of the Humio Documentation.
Regarding the repositories shown, if you’re accessing Humio through a Humio Cloud account, you’ll see most of the repositories shown in Figure 1 here, but not Testeroo. That was created in the Getting Started tutorial in the Training section of the Humio Library.
humio-audit repository is where data internal to Humio is recorded. If you click on it, you’ll see that it shows log entries regarding you using the User Interface and other respositories. The humio-metrics shows Humio usage information. The
sandbox is reserved as a place for you to test Humio. You’ll have to set up log shippers to send data to this repository.
Although you might send actual server logs and metrics to the sandbox repository, you wouldn’t use it in production.
To add a new repository, + Add New button. That will show a box similar to the one in Figure 2 here. Notice that you have the choice of creating a View or a Repository. Views are covered on the Views documentation page.
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. For more information on repositories see Create Repositories.
When creating a new repository, you will be presented with the Repo Settings page. To ingest data into the repository, you will need to set up log shippers on your server. See the Ingest Data and Log Shippers sections of the documentation for more information.