added documentation for datasource v1 and v2

umh.docs.umh.app/archetypes/grafana-plugins.md

@@ -0,0 +1,19 @@
+---
+title: "{{ replace .Name "-" " " | title }}"
+content_type: grafana-plugin
+description: |
+The technical documentation of the {{ .Name }} plugin,
+which
+weight: 0
+---
+
+<!-- overview -->
+
+<!-- body -->
+
+<!-- Add the prerequisites section only if needed -->
+## {{% heading "prerequisites" %}}
+
+## {{% heading "howitworks" %}}
+
+## {{% heading "configuration" %}}

umh.docs.umh.app/content/en/docs/architecture/microservices/grafana-plugins/factoryinput-panel.md

@@ -2,12 +2,12 @@
 title: "Factoryinput-panel"
 content_type: task
 description: |
-    This page has the technical documentation of the microservice factoryinput-panel, which allows for easy execution of MQTT messages inside the UMH stack from a Grafana panel.
-weight: 9000
+    This page contains the technical documentation of the plugin factoryinput-panel, which allows for easy execution of MQTT messages inside the UMH stack from a Grafana panel.
+weight: 3000
 ---
 
 {{% notice warning %}}
-This microservice is still in development and is not considered stable for production use
+This plugin is still in development and is not considered stable for production use
 {{% /notice %}}
 
 

umh.docs.umh.app/content/en/docs/architecture/microservices/grafana-plugins/umh-datasource-v2.md

@@ -0,0 +1,61 @@
+---
+title: "Umh Datasource V2"
+content_type: grafana-plugin
+description: |
+    This page contains the technical documentation of the umh-datasource-v2 plugin,
+    which allows for easy data extraction from factoryinsight.
+weight: 1000
+---
+
+<!-- overview -->
+
+The plugin, **umh-datasource-v2**, is a Grafana data source plugin that allows you to fetch
+resources from a database and build queries for your dashboard.
+
+<!-- body -->
+
+## {{% heading "howitworks" %}}
+
+1. When creating a new panel, select **umh-datasource-v2** from the Data source drop-down menu. It will then fetch the resources
+   from the database. The loading time may depend on your internet speed.
+
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingV2.png?width=80%)
+
+2. Select the resources in the cascade menu to build your query. **DefaultArea** and **DefaultProductionLine** are placeholders
+   for the future implementation of the new data model.
+
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingWorkCell.png?width=80%)
+
+3. Only the available values for the specified work cell will be fetched from the database. You can then select which data value you want to query.
+
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingValue.png?width=80%)
+
+4. Next you can specify how to transform the data, depending on what value you selected.
+   Below you can find the options to transform the queried data:
+
+   - **Time bucket**: lets you group data in a time bucket
+   - **Aggregates**: common statistical aggregations (maximum, minimum, sum or count)
+   - **Handling missing values**: lets you choose how missing data should be handled
+   - **Keep state integer**. lets you keep the state as an integer instead of converting it into its corresponding string
+   - **Include running processes**: includes the running processes
+   - **Keep states**: keeps the state as an integer or string
+
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingOptions.png?width=80%)
+
+## {{% heading "configuration" %}}
+
+1. In Grafana, navigate to the Data sources configuration panel.
+
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsConfigurationPanel.png?width=15%)
+
+2. Select **umh-v2-datasource** to configure it.
+
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsSelectingConfiguration.png?width=80%)
+
+3. Configurations:
+    - Base URL: the URL for the factoryinsight backend. Defaults to `http://{{< resource type="service" name="factoryinsight" >}}/`.
+    - Enterprise name: previously **customerID** for the old datasource plugin. Defaults to **factoryinsight**.
+    - API Key: authenticates the API calls to factoryinsight.
+      Can be found with UMHLens by going to Secrets → {{< resource type="secret" name="factoryinsight" >}} → apiKey. It should follow the format `Basic xxxxxxxx`.
+
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsConfuguringDatasourceV2.png?width=80%)

umh.docs.umh.app/content/en/docs/architecture/microservices/grafana-plugins/umh-datasource.md

@@ -1,44 +1,46 @@
-+++
-title = "umh-datasource"
-menuTitle = "umh-datasource"
-chapter = false
-weight = 5
-draft = false
-description = "The technical documentation of the microservice umh-datasource, which allows for easy data extraction from factoryinsight."
-+++
+---
+title: "Umh Datasource"
+content_type: grafana-plugin
+description: |
+    This page contains the technical documentation of the plugin umh-datasource, which allows for easy data extraction from factoryinsight.
+weight: 2000
+---
 
-UMH Datasource provides a Grafana 8.X compatible plugin, allowing easy data extraction from the UMH factoryinsight microservice.
+<!-- overview -->
 
-## Get started
+{{% notice warning %}}
+We are no longer maintaining this plugin. Instead, use our new plugin datasource-v2 for data extraction from factoryinsight.
+{{% /notice %}}
 
-For development, the steps to build the plugin from source are described here. 
+The **umh datasource** is a Grafana 8.X compatible plugin, that allows you to fetch resources from a database
+and build queries for your dashboard.
 
-1. Clone the datasource repository `[email protected]:united-manufacturing-hub/united-manufacturing-hub-datasource.git`
+<!-- body -->
 
-2. Install dependencies
+## {{% heading "howitworks" %}}
 
-```bash
-yarn install
-```
+1. When creating a new panel, select **umh-datasource** from the Data source drop-down menu. It will then fetch the resources
+   from the database. The loading time may depend on your internet speed.
 
-3. Build plugin in development mode or run in watch mode
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingV1.png?width=85%)
 
-```bash
-yarn dev
-```
+2. Select your query parameters **Location**, **Asset** and **Value** to build your query.
 
-4. Build plugin in production mode (not recommended due to [Issue 32336](https://github.com/grafana/grafana/issues/32336)).
-```bash
-yarn build
-```
-5. Move the resulting dis folder in your Grafana plugins directory.
+   ![selectingDatasource](/images/grafana-plugins/grafanaPluginsSelectingValuesV1.png?width=85%)
 
-- Windows: `C:\Program Files\GrafanaLabs\grafana\data\plugins`
-- Linux: `/var/lib/grafana/plugins`
+## {{% heading "configuration" %}}
 
-6. Rename the folder to umh-datasource.
+1. In Grafana, navigate to the Data sources configuration panel.
 
-7. Enable the [enable development mode](https://grafana.com/docs/grafana/latest/administration/configuration/) to load unsigned plugins.
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsConfigurationPanel.png?width=15%)
 
-8. restart your Grafana service.
+2. Select **umh-datasource** to configure it.
 
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsSelectingConfiguration.png?width=85%)
+3. Configurations:
+    - Base URL: the URL for the factoryinsight backend. Defaults to `http://{{< resource type="service" name="factoryinsight" >}}/`.
+    - Enterprise name: previously **customerID** for the old datasource plugin. Defaults to **factoryinsight**.
+    - API Key: authenticates the API calls to factoryinsight.
+      Can be found with UMHLens by going to Secrets → {{< resource type="secret" name="factoryinsight" >}} → apiKey. It should follow the format `Basic xxxxxxxx`.
+
+   ![selectingConfiguration](/images/grafana-plugins/grafanaPluginsConfiguringDatasourceV1.png?width=85%)