Hetzner Cloud importer
Versio.io can import, historize and process monitoring data from Hetzner Cloud.
Configuration
You can find the configuration option in Versio.io at Environment settings > OneImporter > Configurations > Hetzner Cloud
.
Here you can edit all existing configurations, create new configurations or delete existing configurations.
To add a new configuration enter a Name
for your importer and an Entity suffix
(default: -hetzner-cloud
) to clearly identify your Hetzner Cloud entities.
Note that the Entity suffix
is fixed and cannot be changed afterwards.
Click Add
to proceed to the configuration.
To edit an existing configurations click the arrow on the left of your importer name to expand the configuration options.
Following configuration options are available:
Field | Description | Advice |
---|---|---|
Name | Meaningful name | Add the word "Hetzner Cloud" to identify importer when viewing the logs |
Active | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. | |
Server URL | Hetzner Cloud server URL to get data from | |
API token | Enter your Hetzner Cloud API token | See paragraph below for API token generation in Hetzner Cloud |
Entities | Select all required entities | |
Executing OneImporter | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires installed OneImporter: Installation instruction |
Schedule time (cron format) | Determine the frequency of imports in CRON format | Learn more about CRON format: https://en.wikipedia.org/wiki/Cron |
Table: Hetzner Cloud configuration parameters
The following image is an example of a Hetzner Cloud configuration:
Figure: Example of a Versio.io Hetzner Cloud configuration
Hetzner Cloud API token
An API token for the Hetzner Cloud integration is required to access your Hetzner Cloud environment.
You can find the configuration option in the Hetzner Cloud Console. Choose a project and go to Access > API-Tokens
to create a new API token.
Make sure to copy the token, because it will not be shown to you again. A token is bound to a project, in order to interact with the API of another project you have to create a new token inside the project.
Example
The Versio.io OneImporter imports Hetzner Cloud data based on a specific configuration it in entities with a suffix defined by you (default: -hetzner-cloud
). To view the imported instances in Versio.io, select 'Asset & Configuration Repository → Instance Viewer'. There you can select your specific instance and click it for a detailed view in the instance history viewer.
The following image is an example of imported Hetzner Cloud data:
Figure: Overview of Versio.io Hetzner Cloud instance (left) and topology of related instances (right)