Proemion CLF Analyzer

CLF Analyzer

1. Create Grafana Account

• Create a free Grafana Cloud account with your e-mail.
• or use your existing Local or Cloud Instance. Mind the Grafana and Plugin versions for compatibility.

2. Install the Infinity Plugin

• Go to settings (Hamburger Icon), Connections, and then click on Add new connection
• Search for Infinity
  • Or install directly from Grafana.com at Infinity Plugin
• Install Plugin to your cloud instance. If this does not appear, make sure you are logged in to Grafana, and refresh the page until your cloud instance appears.
  • Install will be different if you have a local Grafana instance.
• Once installed, it can take a few minutes to update on your Grafana Cloud Instance

3. Configure your Grafana Infinity Data Source

• Go to Settings, Connections, Data sources, Add new data source

• Search for Infinity

• Have your Proemion Account Credentials ready. Use of an API Client is recommended with the minimal permissions required:

  Permission	Level
  Machines	Admin
  Location	Location History (optional for GNSS statistics)

  Follow these instructions on how to create a new API Client: https://docs.proemion.com/docs/DataPortal-User-Manual.html#api-client-management

Setup Authentication

• Red: Copy these settings

  • RECOMMENDED Token URL (client credentials) : https://dataportal.proemion.com/api/v23.7.0/auth/token or https://custom.oem.com/api/v23.7.0/auth/token
  • Token URL (username password) : https://dataportal.proemion.com/api/v23.7.0/authz/oauth2/token or https://custom.oem.com/api/v23.7.0/authz/oauth2/token
  • Allowed hosts: https://dataportal.proemion.com or https://custom.oem.com

• Option to use API Client Credentials, OR Username Password Credentials

  • RECOMMENDED Blue Client Credentials
    • Ignore if Username Password is used.
  • OR Green Username and Password (requires additional Endpoint Parameters*)
    • Ignore if Client Credentials is used.

*Username and Password Endpoint Parameters

• Optional Go to the Health Check tab
  • Enable Custom Health True
  • Health check URL https://dataportal.proemion.com/api/v23.7.0/me
• Save and Test to check if you have properly implemented your settings.

4. Import/Update Dashboard Templates

• Go to Dashboards, New, Import
• Import via local file, or via Public Grafana Dashboard Templates
• Copy Dashboard ID into the Import via grafana.com textbox
• Select your Data Source and change any other needed settings.
  • Replace https://dataportal.proemion.com/ with https://custom.oem.com/ if your Proemion White Labeled Account has user locking enabled
  • API version 23.7.0 is minimum supported for CLF Analyzer
• Once imported, you will have a dashboard ready to go.
• If you already have the Dashboard, you can Import (Overwrite) marked in RED to get the latest changes. Just Leave the Name and UID as is and select your Data Source, URL, and API version.

5. Using the CLF Analyzer

• Select the Machine you want to analyze using the Machine ID variable

  • This variable will provide max 1000 machines. You can search for your machine name in the dropdown.
  • The Machine ID variable can also be filtered further by using the Filter type and Filter Value variables to filter by Name, Serial, IMEI, CU Model, CU Serial, Config Version, FW Version. Useful when you have more than 1000 machines as they will not all appear in the initial 1000 list.
  • You can also paste in the direct Machine ID (eg. 123456) into the Machine ID dropdown if you know this ID from the DataPortal.

• If no CLF files are available for the current time Range, you can change the range to a higher value.

• Once you find a range with CLF files, you can directly filter the time range using the Timeseries graph.

• The Time Range Panel will show the range of Time. If it is Red, the time range to too high to see the CLF files. Reduce the time range to Max 1 Hour to see CLF contents. An error will be shown otherwise.

• CLF contents are visible by expanding the CLF Contents and Counts rows at the bottom of the dashboard.