Skip to main content

Cyware Orchestrate

InfluxDB

App Vendor: InfluxData

App Category: Configuration Management Database (CMDB)

Connector Version: 1.1.0

API Version: 2.0.0

About App

InfluxDB is an essential time series data platform that allows developers to build IoT, analytics, and cloud applications all in one place.

The InfluxDB app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Write Data

This action writes data to a bucket in the InfluxDB v2.0 database.

Generic Action

This is a generic action used to make requests to any InfluxDB endpoint.

Configuration Parameters

The following configuration parameters are required for the InfluxDB app to communicate with the InfluxDB enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Hostname

Enter the Hostname to connect with the InfluxDB application.

Example:

https://influx.example.com

Text

Required

Port

Enter the port number to communicate with the InfluxDB application.

Example:

443

Text

Required

Database name

Enter the InfluxDB database name to write data.

Example:

Example Database

Text

Required

Username

Enter the username if authentication is enabled.

Example:

SampleUsername

Text

Optional

Verify SSL

Choose your preference to verify SSL while making requests. It is recommended to set this option to yes. Passing no may result in incorrectly establishing the connection

Boolean

Optional

By default, verification is not enabled.

Timeout

Enter the timeout value in seconds. This is the number of seconds that requests will wait to establish a connection with InfluxDB.

Password

Optional

Allowed range:

15-120

Default value:

15

Action: Write Data

This action writes data to a bucket in the InfluxDB v2.0 database.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Data to Write

Enter the data to write as a list.

Example:

name,project_name=\"eg\",val1=\"3.1.0\" val2=1

Text

Required

InfluxDB uses the line protocol to write data to the database. For more information about syntax and examples, see InfluxDB Documentation.

Bucket Name

Enter the bucket name to write the data.

Example:

my-new-bucket

Text

Required

Example Request

[
    {
        "data_to_write": "name,project_name=\"eg\",val1=\"3.1.0\" val2=1",
        "bucket_name": "my-new-bucket"
    }
]
Action: Generic Action

This is a generic action used to make requests to any InfluxDB endpoint.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Method 

Enter the HTTP method to make the request.

Text

Required

Allowed values:

GET, PUT, POST, DELETE

Endpoint 

Enter the endpoint to make the request to.

/api/v2/write

Text

Required

Query Params 

Enter the query parameters to pass to the API.

Key-Value

Optional

Payload 

Enter the payload to pass to the API.

Any

Optional

Extra Fields 

Enter the extra fields to pass to the API.

Key-Value

Optional

Allowed keys:

payload_json, download, files, filename, retry_wait, retry_count, custom_output, response_type

Example Request 

[
  {
    "method": "GET",
    "endpoint": "api/v2/write",
    "query_params": {
      "page": "0",
      "size": "100"
    }
  }
]