Coralogix Rest API /singles

Send your logs using Rest API /singles endpoint.

Endpoint URL

Create an endpoint URL by inputting the domain associated with your Coralogix account as follows:

https://api.<domain>/logs/rest/singles

For example, if your data is hosted in India, your endpoint URL should appear as https://api.app.coralogix.in/logs/rest/singles

Schema

Endpoint Details

• We recommend sending logs in batches to minimize network calls.
• Group logs from the same application, subsystem, and computer under a single API call using the “logEntries” property.
• 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:

Example

curl --location --request POST 'https://api.coralogix.com/logs/rest/singles' \
  --header 'Content-Type: application/json' \
  --header 'private_key: <Send data 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 you are sending a JSON payload note, we suggest escaping it and then inserting it into the text field, which should be sent as a string.
• If sent in timestamp, use milliseconds or microseconds. If not sent in timestamp , we will inject the UTC time at the time 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].