--- title: Configure the Timeseries DB slug: litmusedge-v1/product-features/datahub/configure-the-timeseries-db description: Learn more about configuring the DataHub timeseries database. docTags: createdAt: 2023-05-04T14:25:54.000Z --- Depending on the version of Litmus Edge you have, refer to the appropriate section to configure the timeseries DB. # Video :::Iframe{iframeHeight="0" code=""} ::: :::hint{type="info"} **Limitation**: When using DataHub for storing data polled from connected devices, it's important to note the following limitations: - InfluxDB initialization for large databases takes a long time with high CPU utilization. Ensure the Litmus Edge device has sufficient computing resources. - DataHub does not store custom-formatted driver output like JSON or arrays to ensure efficient NoSQL timeseries database handling. - DataHub handles string values differently than integers. As a result, when querying stored data, the way string and integer values are handled can impact the structure and results of your query. Sample Influx Query: - **For String Values: **`SELECT "value_str" FROM "temperature_readings" WHERE ("value_str"::field = 'pressure') AND $timeFilter` - **For Integer Values:** `SELECT "value" FROM "temperature_readings" WHERE ("value"::field = 555) AND $timeFilter` ::: # Litmus Edge Version 3.3.2 (and Earlier) and 3.11.0 (and Later) You can configure the Timeseries DB by navigating to **DataHub **>** Configuration**. You have the option of configuring an internal or external InfluxDB timeseries database. DataHub's Configuration module offers the following functionalities: - Toggle the Timeseries DB - Select and Customize Timeseries DB Source type - Test Timeseries DB ## Toggle the Timeseries DB You can enable or disable the Timeseries DB by using the **Timeseries DB disabled** or **Timeseries DB enabled** toggle. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/xc3BjqUGm6gHJZj5g-AaG_image.png "Timeseries DB toggle") ## Select and Customize Timeseries DB Source Type You can change the Timeseries DB source type by using the Source type drop-down list and selecting internal or external. :::hint{type="info"} **Note**: If you select internal, make sure to select the Enable Data Store option for the device you want to store data for. See [Enable Data Store](docId:3eyAfPpweuVmBLCEy17sq) to learn more. ::: ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/3CNZ9KY98h1kjp0GdDm6r_image.png "Source type drop-down list") If you select *external *enter the following details: - **DB uri**: The IP address and port of the externally deployed InfluxDB database. If the InfluxDB database is deployed on the same device as Litmus Edge, enter http\://localhost:8086. - **DB username**: Enter the Influx DB v1.x username. - **DB password**: Enter the Influx DB v1.x password. - **Auth token**: Copy the token for the InfluxDB 2.x database. You can access the database from a browser window and navigate to **Data **> **Tokens**. - **Organization name**: Enter the InfluxDB 2.x organization name configured for the database. - **DB vendor**: The available vendors are - InfluxDB v1.x - InfluxDB v2.x - **Description **(Optional): Enter a description for the externally deployed InfluxDB. - **Name**: Enter a name for the externally deployed InfluxDB. If you select *internal*, no further configurations are required. ## Test the Timeseries DB You can test the connectivity of the Timeseries DB by clicking **Test**. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/A4VU-0lQCBgXy9TxW4bgQ_image.png "The test Timeseries DB button") The connected status and response message displays. # Litmus Edge Version 3.5.2, 3.5.3, 3.5.5, and 3.5.6 :::hint{type="warning"} **Important**: The DataHub (Legacy) configuration page will be removed in a future release. You will need to create new configurations and migrate existing DataHub (Legacy) configurations to the new DataHub page. ::: You can configure the Timeseries DB by navigating to **DataHub **>** DataHub**. You can only configure an external InfluxDB timeseries database. DataHub's Configuration module offers the following functionalities: - Toggle the Timeseries DB - Select and Customize Timeseries DB Source type - Test Timeseries DB ## Toggle the Timeseries DB You can enable or disable the external Timeseries DB by using the **Timeseries DB disabled** or **Timeseries DB enabled** toggle. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/b2wV-Qkme1yyD5oFMCxeM_image.png" size="80" width="1095" height="417" caption="Timeseries DB toggle" position="center" showCaption="true"} ## Configure the Timeseries DB After enabling the Timeseries DB toggle, configure the parameters for the database. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/jyUBPWHeuu2oB1jrl6vX2_image.png" size="80" width="1095" height="417" caption="Timeseries DB fields" position="center" showCaption="true"} - **DB uri**: The IP address and port of the externally deployed InfluxDB database. - **DB vendor**: Select** InfluxDB v2.x **or** InfluxDB v1.x**. - **Description **(Optional): A description for the externally deployed InfluxDB. - **Name**: The configuration name of the externally deployed InfluxDB. Click **Test **to test the connectivity of the database. When done, click **Save**.