Function Definition

function aggregateEvents(groupByMissing,
    groupByTotal,
    aggrigation::String,
    interval::String = "",
    metric::String = "",
    type::String = "",
    fromDateTime::String = "",
    indexes::String = "",
    query::String = "",
    storageTier::String = "",
    toDate::String = "",
    facet::String,
    intreval::Double,
    histogramMin::Double,
    histogramMax::Double,
    groupByLimit::Number = -1,
    sortAggrigation::String = "",
    sortMetric::String = "",
    sortOrder::String = "",
    sortType::String = "",
    timeOffset::Number = -1,
    timeZone::String = "",
    pageCursor::String = "")

Parameters

Function Definition

function getListOfLogs(indexFilter::String, fromDate::DateTime, toDate::DateTime, storageTier::Number, pageCursor::String, pageLimit::Number)

Parameters

- query::String       [Optional]
- index::String       [Optional]
- fromDate::String    [Optional]
- toDate::String      [Optional]
- storageTier::String [Optional]
- sort::String        [Optional]
- cursor::String      [Optional]
- pageLimit::Number   [Optional]

API Call Format:

https://api.datadoghq.com/api/v2/logs/events?filter[query]=`<string>`&filter[index]=`<string>`&filter[from]=`<string>`&filter[to]=`<string>`&filter[storage_tier]=`<enum>`&sort=<enum>&page[cursor]=`<string>`&page[limit]=`<integer>`

Query Strings

| Name                 | Type    | Description                                                                                        |
| :------------------- | :------ | :------------------------------------------------------------------------------------------------- |
| filter[query]        | string  | Search query following logs syntax.                                                                |
| filter[index]        | string  | For customers with multiple indexes, the indexes to search Defaults to ‘*’ which means all indexes |
| filter[from]         | string  | Minimum timestamp for requested logs.                                                              |
| filter[to]           | string  | Maximum timestamp for requested logs.                                                              |
| filter[storage_tier] | enum    | Specifies the storage type to be used. Allowed enum values: `indexes`, `online-archives`           |
| sort                 | enum    | Order of logs in results. Allowed enum values: `timestamp`, `-timestamp`                           |
| page[cursor]         | string  | List following results with a cursor provided in the previous query.                               |
| page[limit]          | integer | Maximum number of logs in the response.                                                            |

# Function Definition:
    handleMessage(message::String)

## Parameters:
    - message::String [Required]
## Functionality:
    Return a string if the "Message" recieved is not ::Vector{String}

# Function Definition:
    function handleMessage(message::Vector{String})

## Parameters:
    - message::Vector{String} [Required]

## Functionality:
    Join messages in a string vector into a single string to be compatible with Datadog

Function Definition:

function sendLogs()

Parameters:

- ddsource::String                       [Optional]
- ddtags::String                         [Optional]
- hostname::String                       [Optional]
- message::Union{String, Vector{String}} [Optional]
- service::String                        [Optional]

Functionality:

Send logs to Datadog.

Limits

HTTP request limits:
- Maximum content size per payload (uncompressed): 5MB
- Maximum size for a single log: 1MB
- Maximum array size if sending multiple logs in an array: 1000 entries

Logs exceeding 1MB will be accepted by Datadog but will be truncated
- For a single log request, the API truncates the log at 1MB and returns a 2xx.
- For a multi-logs request, the API processes all logs, truncates only logs larger than 1MB, and returns a 2xx.
- Datadog recommends sending your logs compressed. Add the Content-Encoding: gzip header to the request when sending compressed logs.

Query Strings:

Header Parameters

Body Data (JSON) [Required]

[
    {
    "ddsource": "nginx",
    "ddtags": "env:staging,version:5.1",
    "hostname": "i-012345678",
    "message": "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World",
    "service": "payment"
    }
]