Send Log Lines

Use this method to send logs to a logging instance.

Authentication

You can find instructions on authentication here. Ingestion is similar to the other APIs, but instead of servicekey you will use apikey if you are using the header style authentication.

Metadata

Meta is a field reserved for custom information associated with a log line. To add metadata to an API call, specify the meta field under the lines object. Metadata can be viewed inside that line’s context

WARNING: If inconsistent value types are used, that line’s metadata, will not be parsed. For example, if a line is passed with a meta object, such as meta.myfield of type String, any subsequent lines with meta.myfield must have a String as the value type for meta.myfield.

Please be aware of service limits on this endpoint

POST /logs/ingest

Send Log Lines

cURL

curl --request POST \
  --url https://logs.mezmo.com/logs/ingest \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "lines": [
    {
      "line": "<string>",
      "timestamp": "<string>",
      "app": "<string>",
      "level": "<string>",
      "meta": "<string>"
    }
  ]
}
'

200

{}

Authorizations

apikeyAuthbasicAuth

apikey · string · header · required

(Deprecated) This key is used for ingestion. You can obtain it following these instructions and placing the key in the header of your call. NOTE Usage of the apikey auth mechanism has been deprecated in favor of IAM Access Tokens. Service keys can no longer be created, but can still be used for v1 and v2 apis while the transition takes place

Query Parameters

hostname · string · required

Host name of the source.

mac · string

The network mac address of the host computer.

Pattern: ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$

Example:

"01:02:03:04:ab:cd"

ip · string

The local IP address of the host computer. The local IP address of the host computer (ipv4 or ipv6)

Example:

"10.0.1.111"

now · string

The source UNIX timestamp in milliseconds at the time of the request. Used to calculate time drift.

tags · string

Tags that are used to dynamically group hosts.

Body

application/json

You can send multiple log lines in a request.

lines · object[]

Show child attributes

Response

200

application/json

OK

{key} · object