Last modified May 30, 2023
Usage data recording in the web interface
In general, when using the Giant Swarm web interface, usage data is collected on these levels:
- The REST API level
- Usage monitoring
- Error data collection
Here we explain the different purposes and what data is recorded.
REST API level
Each request to our REST API is logged for auditing purposes, in case a customer wants to understand modifications made to resources, e. g. the creation or deletion of a cluster.
Note: This is not only the case when using the web interface, but occurs independent of the type of client using the API.
The data stored for each log entry consists of:
- The unique user ID associated with the session token authenticating the request.
- The Path of the API method called (e. g.
- The HTTP method (e. g.
- The date and time when the request has been received.
When using the web interface, some anonymous usage data is collected using a dedicated monitoring service. The recorded data serves several purposes:
- to help Giant Swarm understand how users use the web interface
- to identify performance problems in real world usage
The data recorded consists of:
- Client data: Browser brand and version, device type, display and viewport size.
- The URL viewed.
- Performance related data related to network transfers, content rendering, application readiness.
The data is submitted to a service in the Giant Swarm management cluster.
Error data collection
We like to learn about any exceptions (unexpected errors) happening during web interface usage, hence we forward information about exceptions to Sentry.
Data submitted to sentry includes:
- Browser brand and version
- Operating system name and version
- The URL visited in the web interface
- History of requests (timestamp, URL, HTTP method) made prior to the exception
- Information on any interaction prior to the exception, e. g. a button click
Need help, got feedback?
We listen to your Slack support channel. You can also reach us at firstname.lastname@example.org. And of course, we welcome your pull requests!