HTTP API Exporter

The HTTP API Exporter improves workplace technology experiences by exporting raw data and insights from Nexthink into third-party tools, such as a Configuration Management Data Base (CMDB) and Operation tools like SIEM, IT Ops, AI Ops, Logging, Monitoring and others.

By integrating Nexthink API data exports with third-party tools, you can combine, aggregate and manipulate data to:

• Create powerful up-to-date visualizations with the evolution of specific indicators over time.

• Ensure consistency in the data granularity.

• Combine data from multiple sources to meet compliance and security standards.

• Automate systematic updates for configuration items during and after changes.

Overall, the HTTP API Exporter aims to enhance your understanding of service usage to reduce costs within your organization, for example, by saving service-desk time.

Prerequisites

This integration requires:

• A third-party tool with a public API that allows the system to send multiple records via JSON payload.

• The authorization mechanism to connect to the third-party tool API must be either BASIC, Bearer Token or (Client Credential) OAuth 2.0.

• The JSON payload of the public API third-party tool must support one of the following formats:

  • Collection of JSON objects:

    CODE

    {"property_a":"value_a", "property_b":"value_b"}
    {"property_c":"value_c", "property_d":"value_d"}
    {"property_e":"value_e", "property_f":"value_f"}

  • An array with multiple JSON objects within:

    CODE

    [{"property_a":"value_a", "property_b":"value_b"},
    {"property_c":"value_c", "property_d":"value_d"},
    {"property_e":"value_e", "property_f":"value_f"}]

  • A JSON object with properties and one array:

    CODE

    {
    "property_a":"value_a",
    "property_b":"value_b",
    "records":[
    {"property_c":"value_c", "property_d":"value_d"},
    {"property_e":"value_e", "property_f":"value_f"}
    ]}

Creating an HTTP API data exporter

To configure the data exporter you must have administrative rights.
Refer to the Profiles documentation for more information about user profiles.

To access Data Export:

1. Select Administration from the main menu.

2. Select Outbound connectors from the Integrations section of the navigation panel.

3. Select Data Exporter from the list of Outbound connectors. The Data Exporter page lists the total number of created data exporters.

The Data Export page remains empty until you create your first data exporter.

4. Click on the New Exporter button in the top-right corner of the page to create a new data exporter, and select the HTTP API Exporter option.

5. Fill out the General tab and Data tab on the New exporter page.

6. Click on the Test Load up to 20 records button to execute the NQL query from the Data tab.

7. Click on the Save button at the bottom of the page to validate and create the new data exporter.

General tab

• Name: enter a name for the data exporter.

• Description (optional): enter a meaningful goal for the data exporter.

• Credentials: define the credentials from the third-party tool to enable Nexthink data exports.
  Refer to the Connector credentials documentation for more information.

• Method: define the method the public API supports for sending out data, for example POST, PUT, PATCH.

• Resource: enter the name of the public API endpoint without the protocol and instance, as listed in the following table:

• Scheduling frequency: define how often the system executes the NQL query and exports data. The available options are:

  • Hourly: The system triggers the data export data based on the value selected in the drop-down menu. For instance, every 1h, 2h, 3h, 4h, 6h or 12h.

  • Daily: The system triggers the data export every day at 00:00 of the timezone where the Nexthink cloud instance is located.

  • Weekly: The system triggers the data export weekly, on the selected day at 00:00 of the timezone where the Nexthink cloud instance is located.

  Regardless of the chosen frequency, the execution of the data exporter might be delayed to ensure data completeness. This guarantees no data is missing at the time of the export process.

You must select a value for the Recurrence option because the system does not generate a default value and currently cannot prompt you that the value is missing during the validation process.

Data tab

• NQL query: define the data exported from the Nexthink web interface into the destination using an NQL query.

• Payload structure: select the payload structure to be sent into the third-party tool API.
  Check, in advance, that the public API being targeted supports one of the payload structures referred to on this page.

• Payload (JSON): write the payload structure to be sent to the third-party tool in JSON format. Specify the payload for only one object.

• Payload content helpers: list the variables from the NQL query that the system can use within the payload.

The exporter replicates the object structure as many times as results are generated by the NQL query.

Testing the HTTP data exporter

Click on the Test load up to 20 records button to execute the query configured in the Data tab. The system sends the result to the destination set up in the General tab.

• If the NQL query and the connection are valid, a message appears indicating that the query results has been successfully delivered.

• If the NQL query or the connection is invalid, a message appears informing about the error details.

The following screenshots of Data tabs show different examples of valid queries.

Example of a valid query (JSON object)

Example of a valid query (array)

Example of a valid query (JSON object with an array)

Refer to the Managing data exporters documentation to learn more about data exporters creation, editing, deleting and disabling.

F.A.Q.