Skip to main content

Balena Application

Grafana 9 YouTube CI codecov Balena

Introduction​

The Balena Application plugin for Grafana allows to display device information and manage services using Balena Supervisor API.

Working in a productive alliance, Balena, Grafana, and the Balena Application plugin simplify managing a network of non-homogenous IoT devices. If needed, a device could be made accessible directly, which means internet access is not required.

Requirements​

  • Grafana 8.5+, Grafana 9.0+ is required.

Getting Started​

The Balena Application is not included in the Grafana Catalog. It can be installed manually from our Private Repository or downloaded directly from the GitHub repository:

grafana-cli --repo https://volkovlabs.io/plugins plugins install volkovlabs-balena-app

Features​

  • Allows to display device, release information and service logs using Balena Supervisor API.
  • Provides Services Panel to start, stop, restart Containers.
  • Allows to filter Logs using Regex pattern.
  • Requires Confirmation to restart all Services and reboot the device.
  • Environment Variables sanitized from Target State.

Application

Balena Supervisor​

The balena Supervisor is balena's agent that runs on devices. Its main role is to ensure your app is running, and keep communications with the balenaCloud API server.

The Supervisor has its own set of APIs providing means for services to communicate and execute some special actions that affect the host OS or the services itself.

Provisioning​

Grafana supports managing data sources by adding one or more YAML config files in the provisioning/datasources folder.

Example of provisioning the Balena Supervisor Data Source.

datasources:
  - name: API
    type: volkovlabs-balenasupervisor-datasource
    uid: P9E471951A1B4106C
    jsonData:
      url: ${BALENA_SUPERVISOR_ADDRESS}
    secureJsonData:
      apiKey: ${BALENA_SUPERVISOR_API_KEY}

Feedback​

We love to hear from users, developers, and the whole community interested in this plugin. These are various ways to get in touch with us:

  • Ask a question, request a new feature, and file a bug with GitHub issues.
  • Sponsor our open-source plugins for Grafana with GitHub Sponsor.
  • Star the repository to show your support.

License​

  • Apache License Version 2.0, see LICENSE.