--- title: Enviar logs description: Envía tus logs a la plataforma Datadog por HTTP. breadcrumbs: Documentación > API > Enviar logs --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt). # Enviar 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 Envía tus logs a la plataforma Datadog por HTTP. Estos son los límites por solicitud HTTP: - Tamaño máximo del contenido por carga útil (sin comprimir): 5 MB - Tamaño máximo del log: 1 MB - Tamaño máximo de la matriz (cuando se envían varios logs en una matriz): 1000 entradas Se aceptan logs de más de 1 MB, pero Datadog los truncará de este modo: - En las solicitudes de un solo log, la API trunca el log en 1 MB y devuelve un código 2xx. - En las solicitudes de varios logs, la API los procesa todos, trunca solo los que superan 1 MB y devuelve un código 2xx. Datadog recomienda enviar los logs comprimidos. Añade el encabezado `Content-Encoding: gzip` a la solicitud si vas a enviar logs comprimidos. Los eventos de log pueden enviarse con una marca temporal que se encuentra hasta 18 horas en el pasado. Estos son los códigos de estado HTTP que devuelve la API: - 202: Aceptada (se ha aceptado el procesamiento de la solicitud) - 400: Solicitud incorrecta (probablemente se deba al formato de la carga útil) - 401: Sin autorización (probablemente falte una clave de API) - 403: Problema de permiso (probablemente se haya usado una clave de API no válida) - 408: Se ha agotado el tiempo de espera (la solicitud debe volver a enviarse pasado un tiempo) - 413: Carga útil demasiado elevada (el lote supera los 5 MB sin comprimir) - 429: Demasiadas solicitudes (la solicitud debe volver a enviarse pasado un tiempo) - 500: Error interno del servidor (el servidor se ha enfrentado a una situación inesperada y no ha podido satisfacer la solicitud; la solicitud debe volver a enviarse pasado un tiempo) - 503: Servicio no disponible (el servidor no puede gestionar la solicitud, probablemente porque está sobrecargado; la solicitud debe volver a enviarse pasado un tiempo) ### 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 que hay que enviar (en formato JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ddsource | string | Mensaje del log estructurado. | | 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 Envía tus logs a tu plataforma Datadog a través de HTTP. Los límites por solicitud HTTP son: - Tamaño máximo de contenido por carga útil (sin comprimir): 5MB - Tamaño máximo para un único log: 1MB - Tamaño máximo de la matriz, si se envían varios logs en una matriz: 1000 entradas Cualquier log que supere 1MB es aceptado y truncado por Datadog: - Para una única solicitud de log, la API trunca el log a 1MB y devuelve un 2xx. - Para una solicitud de varios logs, la API procesa todos los logs, trunca sólo los logs mayores a 1MB, y devuelve un 2xx. Datadog recomienda enviar tus logs comprimidos. Añade la cabecera `Content-Encoding: gzip` a la solicitud cuando envíes logs comprimidos. Los códigos de estado que responde la API HTTP son: - 200: OK - 400: Solicitud incorrecta (probablemente un problema en el formato de la carga útil) - 403: Problema de permisos (probablemente se ha utilizado una clave de API no válida) - 413: Carga demasiado grande (el lote supera los 5 MB sin comprimir) - 5xx: Error interno, la solicitud debe ser reintentada después de algún tiempo ### 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) Registro que hay que enviar (en formato JSON). {% tabs %} {% tab label="Model" %} | Field | Type | Description | | -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ddsource | string | Mensaje de registro estructurado. | | 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 %}