ATSD Server Connection

Overview

In order for Axibase Collector to function properly, Collector needs to know where to send data collected from remote data sources.

This document describes how to add a storage driver for sending data into ATSD.

Collector Account

HTTP Pool

Since Axibase Collector transmits data to ATSD using the http/https protocol, you need to configure a HTTP connection pool by specifying connection properties, as well as various timeouts and limits.

  • Open Data Sources > HTTP Pools and click Add to arrive at the appropriate form.
  • Enter a pool name.
  • Set connection parameters to the target ATSD instance: hostname/IP address; port (8443); https protocol.
  • Check Ignore SSL Certificate Errors to ignore certificate errors since ATSD certificate is self-signed by default.
  • Apply connection limits using the recommended settings below.
  • Select Authentication Type=BASIC. Set Test Path to /ping.
  • Enter collector account credentials.
    Make sure that the user has roles API_DATA_WRITE and API_META_WRITE, as well as All Access: Write permission.

Test HTTP Pool

Click Test to verify the settings:

  • Response code is 200 OK if the connection is successful and credentials are valid.
  • Response code is 401 Unauthorized if credentials are not valid.
  • Response code is 403 Forbidden if the specified user is not authorized to access the specified Test Path.
Setting Value
Max Connections 16
Use Cookies false
Connection Pool Timeout 15
Connect Timeout 15
Close Idle Connections interval 60
Read Timeout 15
Socket Linger 0
Socket Reuse true
Socket Keep-Alive true

ATSD HTTP Pool Configuration Example

ATSD HTTP Pool

Storage Driver Configuration

  • Open the Admin > Storage Drivers page and click Add.
  • Choose ATSD HTTP pool configured previously.
  • Set Transport Type to HTTP_BATCH.
  • Keep API path as /api/v1.
  • Click Test. ATSD returns response code 200 OK if the connection was successful.

ATSD Server Test