Appearance

HTTP ​

Datable supports ingesting batched log data via HTTPS requests. This source accepts POST requests over HTTPS and can be used for custom implementations.

Table of Contents ​

Configuring your request ​

  • Endpoint: https://YOUR_DATABLE_HOST.dtbl.io:5201/v1/json
  • Method: POST
  • Headers:
    • Content-Type: application/json
  • Body: JSON array of log objects. See Request Format for details.

Request Format ​

The request must be a JSON array of log objects. Each log object can be configured as follows:

Required Fields ​

  • body (string): The actual log message content.
  • timestamp (string or number): The time the log occurred. Must be in one of the following formats:
    • ISO 8601 format (e.g., 2024-12-01T14:23:30.123Z)
    • Epoch time in seconds (e.g., 1684102345)
    • Epoch time in milliseconds (e.g., 1684102345123)
    • Epoch time in nanoseconds (e.g., 1684102345123456789)

Optional Fields ​

  • service.name (string): If provided, will populate the resource[service.name] field in Datable.

Additional Fields ​

Any other fields included in log objects will be saved as attributes within Datable.

Example Payload ​

json
[
  {
    "body": "User login successful",
    "timestamp": "2025-03-31T12:34:56.789Z",
    "service.name": "auth-service",
    "user_id": "12345",
    "ip_address": "192.0.2.1"
  },
  {
    "body": "Database error",
    "timestamp": 1684102345123,
    "error_code": "DB1001",
    "severity": "error"
  }
]