--- title: Envoyer des logs description: Envoyez vos logs à votre plateforme Datadog via HTTP. breadcrumbs: Documentation > API > Envoyer des logs --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt). # Envoyer des logs ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------- | | app.datadoghq.com | POST https://http-intake.logs.datadoghq.com/api/v2/logs | | us3.datadoghq.com | POST https://http-intake.logs.us3.datadoghq.com/api/v2/logs | | us5.datadoghq.com | POST https://http-intake.logs.us5.datadoghq.com/api/v2/logs | | app.datadoghq.eu | POST https://http-intake.logs.datadoghq.eu/api/v2/logs | | ap1.datadoghq.com | POST https://http-intake.logs.ap1.datadoghq.com/api/v2/logs | | ap2.datadoghq.com | POST https://http-intake.logs.ap2.datadoghq.com/api/v2/logs | | uk1.datadoghq.com | POST https://http-intake.logs.uk1.datadoghq.com/api/v2/logs | | app.ddog-gov.com | POST https://http-intake.logs.ddog-gov.com/api/v2/logs | | us2.ddog-gov.com | POST https://http-intake.logs.us2.ddog-gov.com/api/v2/logs | ### Overview Envoyez vos logs à votre plateforme Datadog via HTTP. Les limites par requête HTTP sont les suivantes : - Taille maximale du contenu par charge utile (sans compression) : 5 Mo - Taille maximale d'un log : 1 Mo - Taille maximale d'un tableau en cas d'envoi de plusieurs logs dans un tableau : 1 000 entrées Tous les logs dépassant 1 Mo sont acceptés et tronqués par Datadog : - Pour une requête avec un seul log, l'API réduit le log de façon à ce qu'il fasse 1 Mo et renvoie un code 2xx. - Pour une requête avec plusieurs logs, l'API traite tous les logs, réduit uniquement les logs dépassant 1 Mo et renvoie un code 2xx. Datadog vous conseille de compresser vos logs avant de les envoyer. Ajoutez l'en-tête `Content-Encoding: gzip` à la requête pour envoyer vos logs compressés. Les événements de logs peuvent être envoyés avec un timestamp pouvant dater de 18 heures maximum. Voici les différents codes de statut renvoyés par l'API HTTP : - 202: Accepted : le traitement de la requête a été accepté. - 400: Bad request : ce statut est probablement dû à une erreur dans le format de la charge utile. - 401: Unauthorized : ce statut est probablement dû à une clé d'API manquante. - 403: Permission issue : ce statut est probablement dû à une clé d'API non valide. - 408: Request Timeout : patientez un peu avant de renvoyer la requête. - 413: Payload too large : la taille du lot est supérieure à 5 Mo une fois décompressé. - 429: Too Many Requests : patientez un peu avant de renvoyer la requête. - 500: Internal Server Error : le serveur a rencontré une condition inattendue l'empêchant de répondre à la demande ; patientez un peu avant de renvoyer la requête. - 503: Service Unavailable : le serveur n'est pas capable de gérer la requête, probablement parce qu'elle surchargée ; patientez un peu avant de renvoyer la requête. ### Arguments #### Query Strings | Field | Type | Description | | ------ | ------ | -------------------------------------------------------------------------- | | ddtags | string | Log tags can be passed as query parameters with `text/plain` content type. | #### Header Parameters | Field | Type | Description | | ---------------- | ---- | ------------------------------------------------------------------------------------------------ | | Content-Encoding | enum | HTTP header used to compress the media-type. Allowed enum values: `identity`, `gzip`, `deflate`. | ### Request #### Body Data (required) Log à envoyer (format JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ddsource | string | Message de log structuré. | | ddtags | string | Tags associated with your logs. | | hostname | string | The name of the originating host of the log. | | message [*required*] | string | The message [reserved attribute](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention.md#reserved-attributes) of your log. By default, Datadog ingests the value of the message attribute as the body of the log entry. That value is then highlighted and displayed in the Logstream, where it is indexed for full text search. | | service | string | The name of the application or service generating the log events. It is used to switch from Logs to APM, so make sure you define the same value when you use both products. See [reserved attributes](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention.md#reserved-attributes). | {% /tab %} {% tab label="Example" %} **Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response** ```json [ { "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" } ] ``` **Send deflate logs with explicit compression returns "Request accepted for processing (always 202 empty JSON)." response** ```json [ { "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" } ] ``` **Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response** ```json [ { "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" } ] ``` {% /tab %} {% /tabs %} ### Response {% tabs %} {% tab label="202" %} Request accepted for processing (always 202 empty JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | ----- | ---- | ----------- | {% /tab %} {% tab label="Example" %} ```json {} ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="401" %} Unauthorized {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="403" %} Forbidden {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="408" %} Request Timeout {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="413" %} Payload Too Large {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too Many Requests {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="500" %} Internal Server Error {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="503" %} Service Unavailable {% tabs %} {% tab label="Model" %} Invalid query performed. | Parent field | Field | Type | Description | | ------------ | ------ | -------- | ------------------ | | | errors | [object] | Structured errors. | | errors | detail | string | Error message. | | errors | status | string | Error code. | | errors | title | string | Error title. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ { "detail": "Malformed payload", "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" printf '%s' "$(cat <<'EOF' [ { "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" } ] EOF )" | python3 -c 'import sys, zlib; sys.stdout.buffer.write(zlib.compress(sys.stdin.buffer.read()))' | curl -X POST "https://http-intake.logs.${DD_SITE}/api/v2/logs" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: deflate" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" printf '%s' "$(cat <<'EOF' [ { "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" } ] EOF )" | python3 -c 'import sys, zlib; sys.stdout.buffer.write(zlib.compress(sys.stdin.buffer.read()))' | curl -X POST "https://http-intake.logs.${DD_SITE}/api/v2/logs" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: deflate" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" echo $(cat << EOF [ { "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" } ] EOF ) | gzip | curl -X POST "https://http-intake.logs.${DD_SITE}/api/v2/logs" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: gzip" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` {% /tab %} {% tab label="Go" %} ```go // Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { body := []datadogV2.HTTPLogItem{ { Ddsource: datadog.PtrString("nginx"), Ddtags: datadog.PtrString("env:staging,version:5.1"), Hostname: datadog.PtrString("i-012345678"), Message: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World", Service: datadog.PtrString("payment"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV2.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV2.CONTENTENCODING_DEFLATE)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` ```go // Send deflate logs with explicit compression returns "Request accepted for processing (always 202 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { body := []datadogV2.HTTPLogItem{ { Ddsource: datadog.PtrString("nginx"), Ddtags: datadog.PtrString("env:staging,version:5.1"), Hostname: datadog.PtrString("i-012345678"), Message: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World", Service: datadog.PtrString("payment"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV2.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV2.CONTENTENCODING_DEFLATE)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` ```go // Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { body := []datadogV2.HTTPLogItem{ { Ddsource: datadog.PtrString("nginx"), Ddtags: datadog.PtrString("env:staging,version:5.1"), Hostname: datadog.PtrString("i-012345678"), Message: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World", Service: datadog.PtrString("payment"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV2.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV2.CONTENTENCODING_GZIP)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.LogsApi; import com.datadog.api.client.v2.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v2.model.ContentEncoding; import com.datadog.api.client.v2.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem() .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")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.DEFLATE)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```java // Send deflate logs with explicit compression returns "Request accepted for processing (always 202 // empty JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.LogsApi; import com.datadog.api.client.v2.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v2.model.ContentEncoding; import com.datadog.api.client.v2.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem() .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")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.DEFLATE)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```java // Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.LogsApi; import com.datadog.api.client.v2.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v2.model.ContentEncoding; import com.datadog.api.client.v2.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem() .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")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.GZIP)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.logs_api import LogsApi from datadog_api_client.v2.model.content_encoding import ContentEncoding from datadog_api_client.v2.model.http_log import HTTPLog from datadog_api_client.v2.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( 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", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.DEFLATE, body=body) print(response) ``` ```python """ Send deflate logs with explicit compression returns "Request accepted for processing (always 202 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.logs_api import LogsApi from datadog_api_client.v2.model.content_encoding import ContentEncoding from datadog_api_client.v2.model.http_log import HTTPLog from datadog_api_client.v2.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( 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", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.DEFLATE, body=body) print(response) ``` ```python """ Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.logs_api import LogsApi from datadog_api_client.v2.model.content_encoding import ContentEncoding from datadog_api_client.v2.model.http_log import HTTPLog from datadog_api_client.v2.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( 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", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.GZIP, body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V2::LogsAPI.new body = [ DatadogAPIClient::V2::HTTPLogItem.new({ 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", }), ] opts = { content_encoding: ContentEncoding::DEFLATE, } p api_instance.submit_log(body, opts) ``` ```ruby # Send deflate logs with explicit compression returns "Request accepted for processing (always 202 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V2::LogsAPI.new body = [ DatadogAPIClient::V2::HTTPLogItem.new({ 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", }), ] opts = { content_encoding: ContentEncoding::DEFLATE, } p api_instance.submit_log(body, opts) ``` ```ruby # Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V2::LogsAPI.new body = [ DatadogAPIClient::V2::HTTPLogItem.new({ 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", }), ] opts = { content_encoding: ContentEncoding::GZIP, } p api_instance.submit_log(body, opts) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Send deflate logs returns "Request accepted for processing (always 202 empty // JSON)." response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_logs::LogsAPI; use datadog_api_client::datadogV2::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV2::model::ContentEncoding; use datadog_api_client::datadogV2::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new( "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World".to_string(), ) .ddsource("nginx".to_string()) .ddtags("env:staging,version:5.1".to_string()) .hostname("i-012345678".to_string()) .service("payment".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::DEFLATE), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` ```rust // Send deflate logs with explicit compression returns "Request accepted for // processing (always 202 empty JSON)." response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_logs::LogsAPI; use datadog_api_client::datadogV2::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV2::model::ContentEncoding; use datadog_api_client::datadogV2::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new( "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World".to_string(), ) .ddsource("nginx".to_string()) .ddtags("env:staging,version:5.1".to_string()) .hostname("i-012345678".to_string()) .service("payment".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::DEFLATE), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` ```rust // Send gzip logs returns "Request accepted for processing (always 202 empty // JSON)." response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_logs::LogsAPI; use datadog_api_client::datadogV2::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV2::model::ContentEncoding; use datadog_api_client::datadogV2::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new( "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World".to_string(), ) .ddsource("nginx".to_string()) .ddtags("env:staging,version:5.1".to_string()) .hostname("i-012345678".to_string()) .service("payment".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::GZIP), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Send deflate logs returns "Request accepted for processing (always 202 empty JSON)." response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v2.LogsApi(configuration); const params: v2.LogsApiSubmitLogRequest = { body: [ { 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", }, ], contentEncoding: "deflate", }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` ```typescript /** * Send gzip logs returns "Request accepted for processing (always 202 empty JSON)." response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v2.LogsApi(configuration); const params: v2.LogsApiSubmitLogRequest = { body: [ { 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", }, ], contentEncoding: "gzip", }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` ```typescript /** * Send logs returns "Request accepted for processing (always 202 empty JSON)." response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v2.LogsApi(configuration); const params: v2.LogsApiSubmitLogRequest = { body: [ { 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", additionalProperties: { status: "info", }, }, ], }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" tsc "example.ts" ``` {% /tab %} {% /tabs %} ## v1 | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------- | | app.datadoghq.com | POST https://http-intake.logs.datadoghq.com/v1/input | | us3.datadoghq.com | POST https://http-intake.logs.us3.datadoghq.com/v1/input | | us5.datadoghq.com | POST https://http-intake.logs.us5.datadoghq.com/v1/input | | app.datadoghq.eu | POST https://http-intake.logs.datadoghq.eu/v1/input | | ap1.datadoghq.com | POST https://http-intake.logs.ap1.datadoghq.com/v1/input | | ap2.datadoghq.com | POST https://http-intake.logs.ap2.datadoghq.com/v1/input | | uk1.datadoghq.com | POST https://http-intake.logs.uk1.datadoghq.com/v1/input | | app.ddog-gov.com | POST https://http-intake.logs.ddog-gov.com/v1/input | | us2.ddog-gov.com | POST https://http-intake.logs.us2.ddog-gov.com/v1/input | ### Overview Envoyez vos logs à votre plate-forme Datadog via HTTP. Les limites par requête HTTP sont les suivantes : - Taille maximale du contenu par charge utile (sans compression) : 5 Mo - Taille maximale d'un log : 1 Mo - Taille maximale d'un tableau en cas d'envoi de plusieurs logs dans un tableau : 1 000 entrées Tous les logs dépassant 1 Mo sont acceptés et tronqués par Datadog : - Pour une requête avec un seul log, l'API réduit le log de façon à ce qu'il fasse 1 Mo et renvoie un code 2xx. - Pour une requête avec plusieurs logs, l'API traite tous les logs, réduit uniquement les logs dépassant 1 Mo et renvoie un code 2xx. Nous vous conseillons de compresser vos logs avant de les envoyer. Ajoutez l'en-tête `Content-Encoding: gzip` à la requête pour envoyer vos logs compressés. Voici les différents codes de statut renvoyés par l'API HTTP : - 200: OK - 400: Bad request (probablement une erreur dans la mise en forme de la charge utile) - 403: Permission issue (probablement une clé d'API non valide) - 413: Payload too large (taille du lot supérieure à 5 Mo une fois décompressé) - 5xx: Internal error (la requête sera renvoyée ultérieurement) ### Arguments #### Query Strings | Field | Type | Description | | ------ | ------ | -------------------------------------------------------------------------- | | ddtags | string | Log tags can be passed as query parameters with `text/plain` content type. | #### Header Parameters | Field | Type | Description | | ---------------- | ---- | ------------------------------------------------------------------------------------ | | Content-Encoding | enum | HTTP header used to compress the media-type. Allowed enum values: `gzip`, `deflate`. | ### Request #### Body Data (required) Log à envoyer (format JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ddsource | string | Message de log structuré. | | ddtags | string | Tags associated with your logs. | | hostname | string | The name of the originating host of the log. | | message [*required*] | string | The message [reserved attribute](https://docs.datadoghq.com/logs/log_collection.md#reserved-attributes) of your log. By default, Datadog ingests the value of the message attribute as the body of the log entry. That value is then highlighted and displayed in the Logstream, where it is indexed for full text search. | | service | string | The name of the application or service generating the log events. It is used to switch from Logs to APM, so make sure you define the same value when you use both products. See [reserved attributes](https://docs.datadoghq.com/logs/log_collection.md#reserved-attributes). | {% /tab %} {% tab label="Example" %} **Send deflate logs returns "Response from server (always 200 empty JSON)." response** ```json [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] ``` **Send deflate logs with explicit compression returns "Response from server (always 200 empty JSON)." response** ```json [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] ``` **Send gzip logs returns "Response from server (always 200 empty JSON)." response** ```json [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] ``` {% /tab %} {% /tabs %} ### Response {% tabs %} {% tab label="200" %} Response from server (always 200 empty JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | ----- | ---- | ----------- | {% /tab %} {% tab label="Example" %} ```json {} ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} unexpected error {% tabs %} {% tab label="Model" %} Invalid query performed. | Field | Type | Description | | -------------------- | ------ | -------------- | | code [*required*] | int32 | Error code. | | message [*required*] | string | Error message. | {% /tab %} {% tab label="Example" %} ```json { "code": 0, "message": "Your browser sent an invalid request." } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} Error response object. | Field | Type | Description | | ------------------- | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" printf '%s' "$(cat <<'EOF' [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] EOF )" | python3 -c 'import sys, zlib; sys.stdout.buffer.write(zlib.compress(sys.stdin.buffer.read()))' | curl -X POST "https://http-intake.logs.${DD_SITE}/v1/input" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: deflate" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" printf '%s' "$(cat <<'EOF' [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] EOF )" | python3 -c 'import sys, zlib; sys.stdout.buffer.write(zlib.compress(sys.stdin.buffer.read()))' | curl -X POST "https://http-intake.logs.${DD_SITE}/v1/input" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: deflate" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_API_KEY="" echo $(cat << EOF [ { "message": "Example-Log", "ddtags": "host:ExampleLog" } ] EOF ) | gzip | curl -X POST "https://http-intake.logs.${DD_SITE}/v1/input" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Content-Encoding: gzip" \ -H "DD-API-KEY: ${DD_API_KEY}" \ --data-binary @- ``` {% /tab %} {% tab label="Go" %} ```go // Send deflate logs returns "Response from server (always 200 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { body := []datadogV1.HTTPLogItem{ { Message: "Example-Log", Ddtags: datadog.PtrString("host:ExampleLog"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV1.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV1.CONTENTENCODING_DEFLATE)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` ```go // Send deflate logs with explicit compression returns "Response from server (always 200 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { body := []datadogV1.HTTPLogItem{ { Message: "Example-Log", Ddtags: datadog.PtrString("host:ExampleLog"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV1.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV1.CONTENTENCODING_DEFLATE)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` ```go // Send gzip logs returns "Response from server (always 200 empty JSON)." response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { body := []datadogV1.HTTPLogItem{ { Message: "Example-Log", Ddtags: datadog.PtrString("host:ExampleLog"), }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewLogsApi(apiClient) resp, r, err := api.SubmitLog(ctx, body, *datadogV1.NewSubmitLogOptionalParameters().WithContentEncoding(datadogV1.CONTENTENCODING_GZIP)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `LogsApi.SubmitLog`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `LogsApi.SubmitLog`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Send deflate logs returns "Response from server (always 200 empty JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.LogsApi; import com.datadog.api.client.v1.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v1.model.ContentEncoding; import com.datadog.api.client.v1.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem().message("Example-Log").ddtags("host:ExampleLog")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.DEFLATE)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```java // Send deflate logs with explicit compression returns "Response from server (always 200 empty // JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.LogsApi; import com.datadog.api.client.v1.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v1.model.ContentEncoding; import com.datadog.api.client.v1.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem().message("Example-Log").ddtags("host:ExampleLog")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.DEFLATE)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```java // Send gzip logs returns "Response from server (always 200 empty JSON)." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.LogsApi; import com.datadog.api.client.v1.api.LogsApi.SubmitLogOptionalParameters; import com.datadog.api.client.v1.model.ContentEncoding; import com.datadog.api.client.v1.model.HTTPLogItem; import java.util.Collections; import java.util.List; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); LogsApi apiInstance = new LogsApi(defaultClient); List body = Collections.singletonList( new HTTPLogItem().message("Example-Log").ddtags("host:ExampleLog")); try { apiInstance.submitLog( body, new SubmitLogOptionalParameters().contentEncoding(ContentEncoding.GZIP)); } catch (ApiException e) { System.err.println("Exception when calling LogsApi#submitLog"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Send deflate logs returns "Response from server (always 200 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.logs_api import LogsApi from datadog_api_client.v1.model.content_encoding import ContentEncoding from datadog_api_client.v1.model.http_log import HTTPLog from datadog_api_client.v1.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( message="Example-Log", ddtags="host:ExampleLog", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.DEFLATE, body=body) print(response) ``` ```python """ Send deflate logs with explicit compression returns "Response from server (always 200 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.logs_api import LogsApi from datadog_api_client.v1.model.content_encoding import ContentEncoding from datadog_api_client.v1.model.http_log import HTTPLog from datadog_api_client.v1.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( message="Example-Log", ddtags="host:ExampleLog", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.DEFLATE, body=body) print(response) ``` ```python """ Send gzip logs returns "Response from server (always 200 empty JSON)." response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.logs_api import LogsApi from datadog_api_client.v1.model.content_encoding import ContentEncoding from datadog_api_client.v1.model.http_log import HTTPLog from datadog_api_client.v1.model.http_log_item import HTTPLogItem body = HTTPLog( [ HTTPLogItem( message="Example-Log", ddtags="host:ExampleLog", ), ] ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = LogsApi(api_client) response = api_instance.submit_log(content_encoding=ContentEncoding.GZIP, body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Send deflate logs returns "Response from server (always 200 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V1::LogsAPI.new body = [ DatadogAPIClient::V1::HTTPLogItem.new({ message: "Example-Log", ddtags: "host:ExampleLog", }), ] opts = { content_encoding: ContentEncoding::DEFLATE, } p api_instance.submit_log(body, opts) ``` ```ruby # Send deflate logs with explicit compression returns "Response from server (always 200 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V1::LogsAPI.new body = [ DatadogAPIClient::V1::HTTPLogItem.new({ message: "Example-Log", ddtags: "host:ExampleLog", }), ] opts = { content_encoding: ContentEncoding::DEFLATE, } p api_instance.submit_log(body, opts) ``` ```ruby # Send gzip logs returns "Response from server (always 200 empty JSON)." response require "datadog_api_client" api_instance = DatadogAPIClient::V1::LogsAPI.new body = [ DatadogAPIClient::V1::HTTPLogItem.new({ message: "Example-Log", ddtags: "host:ExampleLog", }), ] opts = { content_encoding: ContentEncoding::GZIP, } p api_instance.submit_log(body, opts) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Send deflate logs returns "Response from server (always 200 empty JSON)." // response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_logs::LogsAPI; use datadog_api_client::datadogV1::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV1::model::ContentEncoding; use datadog_api_client::datadogV1::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new("Example-Log".to_string()) .ddtags("host:ExampleLog".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::DEFLATE), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` ```rust // Send deflate logs with explicit compression returns "Response from server // (always 200 empty JSON)." response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_logs::LogsAPI; use datadog_api_client::datadogV1::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV1::model::ContentEncoding; use datadog_api_client::datadogV1::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new("Example-Log".to_string()) .ddtags("host:ExampleLog".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::DEFLATE), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` ```rust // Send gzip logs returns "Response from server (always 200 empty JSON)." response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_logs::LogsAPI; use datadog_api_client::datadogV1::api_logs::SubmitLogOptionalParams; use datadog_api_client::datadogV1::model::ContentEncoding; use datadog_api_client::datadogV1::model::HTTPLogItem; use std::collections::BTreeMap; #[tokio::main] async fn main() { let body = vec![HTTPLogItem::new("Example-Log".to_string()) .ddtags("host:ExampleLog".to_string()) .additional_properties(BTreeMap::from([]))]; let configuration = datadog::Configuration::new(); let api = LogsAPI::with_config(configuration); let resp = api .submit_log( body, SubmitLogOptionalParams::default().content_encoding(ContentEncoding::GZIP), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Send deflate logs returns "Response from server (always 200 empty JSON)." response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.LogsApi(configuration); const params: v1.LogsApiSubmitLogRequest = { body: [ { message: "Example-Log", ddtags: "host:ExampleLog", }, ], contentEncoding: "deflate", }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` ```typescript /** * Send gzip logs returns "Response from server (always 200 empty JSON)." response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.LogsApi(configuration); const params: v1.LogsApiSubmitLogRequest = { body: [ { message: "Example-Log", ddtags: "host:ExampleLog", }, ], contentEncoding: "gzip", }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` ```typescript /** * Send logs returns "Response from server (always 200 empty JSON)." response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.LogsApi(configuration); const params: v1.LogsApiSubmitLogRequest = { body: [ { message: "Example-Log", ddtags: "host:ExampleLog", }, ], }; apiInstance .submitLog(params) .then((data: any) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" tsc "example.ts" ``` {% /tab %} {% /tabs %}