Coralogix REST API /singles

Send your logs using the Coralogix REST API /singles.

Endpoint URL

Input your Coralogix domain into the following endpoint URL: https://ingress.<span class="domain-value"></span>/logs/v1/singles.

Schema

Endpoint Details


URL	https://ingress./logs/v1/singles
HTTP Method	POST
Content-Type	application/json
Header	Authorization: Bearer Send-Your-Data API key

We recommend sending logs in batches to minimize network calls.
The API is limited to a message size of 2MB which is approximately 3,000 medium-sized logs.
If you are using Ajax or a similar technology, you may need to send the data with JSON.stringify()).

POST Body

An array of JSON objects which contain:

Required	Property Name	Property Type	Note
	timestamp	number	UTC milliseconds since 1970 (supports sub-millisecond via a floating point)
Yes	applicationName	string	usually used to separate environments
Yes	subsystemName	string	usually used to separate components
	computerName	string
	severity	number	1 – Debug, 2 – Verbose, 3 – Info, 4 – Warn, 5 – Error, 6 – Critical
	category	string	Category field
	className	string	Class field
	methodName	string	Method field
	threadId	string	Thread ID field
	hiResTimestamp	string	UTC nanoseconds since 1970(supports millisecond, microsecond and nanosecond)
Yes	text	string/json	event log

Example

curl --location --request POST 'https://ingress.<span class="domain-value"></span>/logs/v1/singles' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <Send-Your-Data API key>' \
  --data-raw '[{
      "applicationName": "*insert desired application name*",
      "subsystemName": "*insert desired subsystem name*",
      "computerName": "*insert computer name*",
      "severity": 3,
      "text": "this is a normal text message",
      "category": "cat-1",
      "className": "class-1",
      "methodName": "method-1",
      "threadId": "thread-1",
      "timestamp": 1675148539123.342
    }, {
      "applicationName": "*insert desired application name*",
      "subsystemName": "*insert desired subsystem name*",
      "computerName": "*insert computer name*",
      "hiResTimestamp": "1675148539789123123",
      "severity": 5,
      "text": "{\"key1\":\"val1\",\"key2\":\"val2\",\"key3\":\"val3\",\"key4\":\"val4\"}",
      "category": "DAL",
      "className": "UserManager",
      "methodName": "RegisterUser",
      "threadId": "a-352"
    }]'

Note: If timestamp is present, use milliseconds or microseconds. If not, we will inject the UTC time when the request is received.

Coralogix Dashboard

View your logs, with all metadata fields, in your Coralogix dashboard.

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at [email protected].

Coralogix REST API

Next Coralogix REST API /bulk