Before your Humio Cloud account can receive data, you’ll need to prepare it. This will involve two tasks: First, you’ll have to create a repository to hold the data. This will be where you’ll later be able to search and monitor the logs and other metrics from your server. Second, you’ll need to generate some authentication tokens for your server to use, so that Humio Cloud will know it’s safe to accept the data.
Data sent to the Humio Cloud needs to be stored in a repository. Although you may still be using a trial account, instead of using the Sandbox repository from the interactive tutorial, you should create your own repository. That may seem like a bother, but it will give you some experience creating repositories.
To start, click on the rectangular button labeled, +Add Item (see cropped screenshot in Figure 1). That will open a screen with icons for choosing one of three options: a View, which is not what you want at this point; a Repository, which you would think it is what you want, but that’s for when you have a paid account; and Trial Repository, which is what you want.
After choosing Trial Repository, you’ll be asked to give the repository a name and a description. Enter that information in the respective boxes and then click, +Create Repository. When that’s finished, you’ll see a screen with panels for administering the repository you just created. It’s here that you’ll generate authentication tokens that will be needed to receive data in your repository.
For your repository to receive data, you have to install some tools on your server to send that data to Humio. We call these data shippers. You’ll need to decide on which software you want to use on your server. There are several choices, depending on what you want to monitor in Humio. Whichever ones you install, you’ll also need to get an authentication token, also called an ingest token, from your Humio Cloud account to add to the configuration of those data shippers. Let’s make some assumptions and get that ready.
To generate an ingest tokens, go to your Humio Cloud account and click on Settings in the top menu. On the screen that it reveals, click on API Tokens under Ingest. There you will see that a default token has been created already. You can also add more tokens. Let add two.
In the input box under the heading, New Ingest Token, enter the name of a new token and then click + Create Token. You can see in the screenshot in Figure 2 that we created two tokens:
my_rsyslog. Although it’s not always necessary, we will use a separate token for each data shipper that we’ll install in the next page of this tutorial. Incidentally, these ingest tokens are specific to the repository. If you create another repository, it will need its own authentication tokens.
When the data comes in, so that Humio knows how to parse it properly, you set a parser to associate with the ingest token. In the screenshot here, you can see that we set
my_vector to the accesslog parser, and the
my_rsyslog to syslog. That’s because on the next page of this tutorial, we’ll install the
rsyslog utilities on our server: they’ll be our data shippers.
When you’ve finished creating your respository and generating two ingest tokens, you’re ready to go to the next page of this tutorial. To do that, click on the Next Page button here.