Meta tags:
description= Deliver observability data to an HTTP server;
keywords= http,client,component,sink,logs,metrics,traces;
Headings (most frequently used words):
encoding, auth, request, framing, tls, cef, csv, syslog, adaptive_concurrency, buffer, proxy, length_delimited, batch, concurrency, protobuf, imds, healthcheck, retry_strategy, health, checks, enabled, http, acknowledgements, method, uri, metrics, rate, limits, adaptive, max_events, timeout_secs, type, avro, gelf, json, character_delimited, max_frame_length, headers, extensions, severity, delimiter, deprecated, configuration, input, types, telemetry, how, it, works, vector, site, footer, example, configurations, compression, inputs, payload_prefix, payload_suffix, logs, traces, buffers, and, batches, retry, policy, state, transport, layer, security, about, components, setup, community, download, password, service, strategy, token, user, value, max_bytes, max_size, when_full, codec, except_fields, metric_tag_values, only_fields, timestamp_format, https, no_proxy, rate_limit_duration_secs, rate_limit_num, retry_attempts, retry_initial_backoff_secs, retry_jitter_mode, retry_max_duration_secs, status_codes, alpn_protocols, ca_file, crt_file, key_file, key_pass, server_name, verify_certificate, verify_hostname, buffer_byte_size, buffer_discarded_events_total, buffer_events, buffer_received_event_bytes_total, buffer_received_events_total, buffer_sent_event_bytes_total, buffer_sent_events_total, buffer_size_bytes, buffer_size_events, component_discarded_events_total, component_errors_total, component_received_event_bytes_total, component_received_events_count, component_received_events_total, component_sent_bytes_total, component_sent_event_bytes_total, component_sent_events_total, utilization, require, disable, arc, static, access_key_id, assume_role, credentials_file, external_id, load_timeout_secs, profile, region, secret_access_key, session_name, session_token, schema, device_event_class_id, device_product, device_vendor, device_version, name, version, capacity, double_quote, escape, fields, quote, quote_style, max_chunk_size, pretty, desc_file, message_type, use_json_names, app_name, facility, msg_id, proc_id, rfc, length_field_is_big_endian, length_field_length, length_field_offset, decrease_ratio, ewma_alpha, initial_concurrency, max_concurrency_limit, rtt_deviation_scale, connect_timeout_seconds, max_attempts, read_timeout_seconds,
Text of the page (most frequently used words):
the (491), optional (153), #vector (122), this (83), string (78), component (73), for (70), literal (59), encoding (56), default (54), and (53), are (52), when (50), that (49), event (48), data (45), request (41), required (39), type (39), auth (37), from (34), http (33), examples (33), use (33), which (32), enum (32), options (31), aws (29), can (28), object (28), not (27), concurrency (27), events (27), with (26), number (26), value (26), file (24), buffer (24), host (24), uint (24), field (24), you (23), bytes (23), configuration (22), hostname (22), path (22), uri (22), metrics (22), relevant (22), must (22), values (21), option (20), used (20), csv (20), cef (20), logs (19), set (19), process (19), name (19), instance (18), pid (18), system (18), running (18), component_type (18), kind (18), component_kind (18), component_id (18), originated (18), codec (18), json (18), tls (16), description (16), sinks (15), requests (15), log (15), format (15), strategy (15), timestamp (15), syslog (15), sink (14), than (14), valid (14), certificate (14), protobuf (14), length (14), counter (13), maximum (13), framing (13), message (13), gelf (13), all (12), will (12), retry (12), adaptive (12), more (12), compression (12), also (11), limit (11), batch (11), endpoint (11), transform (11), any (11), proxy (11), source (11), fields (11), authentication (11), service (10), output (10), supported (10), https (10), example (10), method (10), encodes (10), acknowledgements (10), seconds (9), mode (9), metric (9), full (9), enabled (9), bool (9), server (9), key (9), they (9), custom (9), less (9), character (9), quotes (9), credentials (9), datadog (8), behavior (8), specified (8), health (8), only (8), has (8), none (8), before (8), header (8), delimited (8), length_delimited (8), avro (8), device (8), imds (8), end (8), components (7), input (7), post (7), like (7), internal (7), 212 (7), 9000 (7), time (7), rtt (7), inputs (7), unique (7), basic (7), uses (6), defaults (6), other (6), checks (6), false (6), healthcheck (6), error (6), size (6), instead (6), specific (6), how (6), gauge (6), either (6), level (6), types (6), using (6), pem (6), provided (6), your (6), allowed (6), names (6), equal (6), adaptive_concurrency (6), reference (6), represent (6), unix (6), serializer (6), encoded (6), necessary (6), writing (6), empty (6), prometheus (6), model (6), bearer (6), role (6), my_sink_id (6), gcp (6), github (5), new (5), its (5), these (5), based (5), region (5), sent (5), protocol (5), absolute (5), true (5), currently (5), enables (5), should (5), but (5), remote (5), client (5), com (5), additional (5), list (5), see (5), retries (5), text (5), float (5), matches (5), payload_prefix (5), payload_suffix (5), character_delimited (5), single (5), otlp (5), version (5), product (5), vendor (5), memory (5), disk (5), token (5), password (5), chat (4), openssl (4), via (4), each (4), failed (4), status (4), responses (4), backoff (4), rate_limit_num (4), rate_limit_duration_secs (4), limits (4), static (4), integer (4), performance (4), systems (4), etc (4), require (4), check (4), buffers (4), configured (4), batches (4), concepts (4), them (4), every (4), were (4), origins (4), been (4), deprecated (4), trace (4), traces (4), make (4), unless (4), verification (4), order (4), timeout (4), jitter (4), current (4), support (4), headers (4), average (4), measurements (4), range (4), cause (4), proxying (4), traffic (4), ignored (4), ascii_char (4), delimiter (4), encoder (4), rfc (4), severity (4), tags (4), 8192 (4), quote (4), record (4), native (4), remap (4), specification (4), identifies (4), identifier (4), username (4), docs (4), architecture (4), rss (3), releases (3), download (3), going (3), sources (3), about (3), humio (3), updates (3), protocols (3), due (3), state (3), 500 (3), rate (3), fixed (3), feature (3), such (3), have (3), does (3), downstream (3), blog (3), disable (3), max_events (3), timeout_secs (3), flushed (3), global (3), never (3), total (3), some (3), configurations (3), may (3), sanitized (3), pod (3), pod_name (3), pathname (3), peer_path (3), peer_addr (3), connection (3), container (3), container_name (3), note (3), useful (3), histogram (3), passed (3), within (3), errors (3), dropped (3), non (3), following (3), template (3), include (3), part (3), connections (3), common (3), extension (3), key_file (3), der (3), pkcs (3), additionally (3), inline (3), codes (3), retry_strategy (3), information (3), below (3), could (3), amount (3), wait (3), into (3), delay (3), after (3), window (3), one (3), given (3), past (3), deviation (3), increases (3), scale (3), greater (3), put (3), lead (3), hosts (3), prefix (3), least (3), well (3), whether (3), varint_length_delimited (3), bit (3), byte (3), point (3), rfc5424 (3), tag (3), exposed (3), strings (3), same (3), controls (3), graylog (3), puts (3), around (3), means (3), configures (3), escape (3), capacity (3), logfmt (3), while (3), opentelemetry (3), experimental (3), apache (3), points (3), extensions (3), combination (3), schema (3), lost (3), buffering (3), authorization (3), session (3), assume (3), observability (3), websocket (3), splunk (3), hec (3), azure (3), kinesis (3), administration (2), deployment (2), installation (2), setup (2), transforms (2), honeycomb (2), content (2), adjust (2), environment (2), variable (2), transport (2), security (2), stateless (2), across (2), control (2), retry_attempts (2), both (2), highly (2), enabling (2), algorithms (2), arc (2), config (2), yaml (2), healthy (2), upon (2), failure (2), accept (2), proceed (2), meets (2), exceeds (2), max_bytes (2), age (2), conditions (2), above (2), treats (2), delivery (2), guarantees (2), ratio (2), would (2), indicate (2), idle (2), waiting (2), emitted (2), send (2), destination (2), raw (2), accepted (2), tagged (2), cumulatively (2), separate (2), batching (2), issues (2), topology (2), stage (2), intentionally (2), filter (2), buffer_size_events (2), buffer_size_bytes (2), received (2), favor (2), telemetry (2), supports (2), per (2), syntax (2), port (2), understand (2), risks (2), verifying (2), outgoing (2), connect (2), present (2), presented (2), certificates (2), issuer (2), create (2), requires (2), upstream (2), host_certificate (2), identify (2), crt (2), 509 (2), alpn (2), defined (2), sets (2), including (2), recommends (2), pile (2), being (2), reduce (2), first (2), select (2), 223372036854776e (2), plain (2), outbound (2), ignore (2), larger (2), algorithm (2), setting (2), takes (2), initial (2), smaller (2), high (2), down (2), parameters (2), typically (2), meta (2), stable (2), addresses (2), 127 (2), multiple (2), foo (2), bar (2), 3128 (2), proxied (2), through (2), making (2), external (2), together (2), produce (2), payload (2), patch (2), head (2), get (2), delete (2), array (2), starts (2), newline_delimited (2), compatible (2), prefixed (2), little (2), endian (2), ascii (2), 388608e (2), frame (2), max_frame_length (2), rfc3164 (2), formatting (2), facility (2), user (2), proto (2), package (2), desc (2), read (2), descriptor (2), last (2), null (2), pretty (2), target (2), keep (2), recommended (2), even (2), strictly (2), always (2), disabled (2), otherwise (2), escaped (2), raw_message (2), native_json (2), careful (2), modifying (2), removing (2), doing (2), parsing (2), emitting (2), sdk (2), loki (2), spec (2), reason (2), pairs (2), keys (2), two (2), products (2), zlib (2), snappy (2), gzip (2), block (2), acceptance (2), consumption (2), free (2), space (2), performant (2), durable (2), restarted (2), forcefully (2), crashes (2), buffered (2), synchronized (2), aqodyxdz (2), access (2), itself (2), profile (2), assume_role (2), metadata (2), arn (2), iam (2), connected (2), handled (2), open (2), home (2), api (2), pipeline (2), statsd (2), socket (2), sematext (2), redis (2), pulsar (2), write (2), nats (2), mqtt (2), formerly (2), kafka (2), influxdb (2), greptimedb (2), pubsub (2), stackdriver (2), cloud (2), storage (2), monitoring (2), sqs (2), firehose (2), cloudwatch (2), amqp (2), route (2), windows (2), kubernetes (2), docker (2), agent (2), linux (2), pipelines (2), guides (2), sidebar, 2026, inc, rights, reserved, community, prod, cookies, privacy, team, contact, site, footer, next, previous, thank, joining, our, newsletter, sign, receive, emails, latest, page, maturity, enable, location, openssl_conf, usr, local, ssl, cnf, layer, meaning, consistent, 408, 429, 501, retried, attempts, retry_backoff_secs, policy, apply, addition, limiting, overall, throughput, manually, specifying, recommend, improves, reliability, communicates, made, further, away, automatically, optimizes, underlying, mechanism, feedback, loop, inspired, tcp, congestion, checkout, announcement, exit, immediately, pass, flag, ensure, accessible, ready, performed, initialization, fails, logged, start, controlled, met, shown, diagram, notice, differently, treating, isolates, ensuring, services, disruptions, contained, honored, works, load, completely, simply, updated, utilization, component_sent_events_total, component_sent_event_bytes_total, excluding, query, component_sent_bytes_total, component_received_events_total, mostly, low, debugging, small, component_received_events_count, component_received_event_bytes_total, occurred, error_type, encountered, component_errors_total, discarded, intentional, component_discarded_events_total, buffer_sent_events_total, buffer_sent_event_bytes_total, buffer_received_events_total, buffer_received_event_bytes_total, buffer_events, blocking, buffer_discarded_events_total, buffer_byte_size, link, summary, distribution, table, lists, possible, aware, available, differ, parameter, dynamic, entry, subject, alternative, verify_hostname, validity, expired, issued, trusted, operates, hierarchical, manner, checking, leaf, until, reaches, root, initiate, validates, verify_certificate, www, indication, sni, server_name, password1, key_pass_env_var, effect, passphrase, unlock, encrypted, key_pass, private, archive, crt_file, certificate_authority, ca_file, declare, during, negotiation, peer, prioritized, alpn_protocols, don, timeouts, details, retrystrategy, retry_action, except, success, 2xx, status_codes, configurable, lower, orphaned, result, duplicate, take, aborted, between, retry_max_duration_secs, incorporating, greatly, likelihood, creating, accidental, denial, dos, against, own, many, clients, recovering, random, anywhere, calculated, retry_jitter_mode, fibonacci, sequence, future, backoffs, attempting, retry_initial_backoff_secs, templating, add, outstanding, managed, positive, denotes, calculating, secondary, computed, indicates, those, comparing, expected, factor, appropriate, reasonable, deviations, considered, anomalous, rtt_deviation_scale, 200, bound, place, safeguard, max_concurrency_limit, seeing, long, ramp, restart, find, looking, adaptive_concurrency_limit, initial_concurrency, exponentially, weighted, moving, ewma, compare, slowly, unusually, response, variability, weighting, compared, older, ewma_alpha, rounded, applying, back, rapidly, latency, fraction, decreasing, decrease_ratio, changes, incorrect, unstable, caution, settings, splat, 192, 168, blocks, cidr, subdomains, wildcard, domains, domain, match, pattern, patterns, avoid, no_proxy, similar, convention, different, proxies, configure, suffix, info, wildcards, ids, scheme, varint, newline, unsigned, length_field_offset, representing, length_field_length, big, length_field_is_big_endian, decoder, delimits, sequences, microseconds, unix_us, nanoseconds, unix_ns, milliseconds, unix_ms, floating, unix_float, 3339, rfc3339, timestamp_format, informational, modern, legacy, proc, proc_id, msg, msg_id, semantic, missing, app, app_name, working, already, converted, interfacing, naming, conventions, looks, their, job_description, jobdescription, camelcase, snake_case, use_json_names, serializing, message_type, protobuf_descriptor_set, here, protoc, desc_file, included, only_fields, show, assigned, arrays, bare, displayed, assignments, metric_tag_values, jsonserializer, chunked, datagram, chunking, datagrams, exceed, decoding, chunked_gelf, max_chunk_size, excluded, except_fields, numeric, parse, aren, non_numeric, writes, produces, invalid, contain, terminator, indistinguishable, quoting, style, quote_style, regex, appear, needs, double_quotes, variants, special, escaping, doubling, doubled, double, escapes, double_quote, writer, 8kb, resembles, export, 3164, 5424, suitable, sending, endpoints, application, forward, implementation, might, continue, relax, enforcement, codecs, maintained, much, relaxed, strict, actual, receiver, adheres, exception, characters, encode, formatted, lowest_importance, highest_importance, reflects, importance, human, readable, 512, equals, collection, paths, problem, sends, messages, device_version, device_vendor, device_product, reported, 1023, device_event_class_id, selected, determines, zstandard, zstd, highest, priority, preferable, temporarily, lose, rather, slowdown, drops, drop_newest, applies, backpressure, signalling, slow, edge, handling, when_full, 500ms, then, 256, megabytes, 268435488, allocated, hold, max_size, individual, found, section, uncompressed, batched, serialized, compressed, processed, custom_prefix, auth_header_value, inserted, oauth2, jwt, concatenated, base64, signing, temporary, session_token, indexer, principal, autogenerated, provider, 1736428351340, assumed, rolesessionname, session_name, wjalrxutnfemi, k7mdeng, bpxrficyexamplekey, secret, secret_access_key, west, sts, develop, chain, successfully, loading, load_timeout_secs, read_timeout_seconds, fetching, tokens, max_attempts, connect_timeout_seconds, authenticating, randomexampleidstring, conjunction, external_id, credentials_file, 123456789098, my_role, akiaiosfodnn7example, access_key_id, without, encryption, beyond, what, disabling, precedence, over, waits, acknowledged, acknowledging, acknowledgement, toml, advanced, minimal, view, egress, yes, once, deliver, versioning, glossary, variables, cli, secrets, unit, tests, webhdfs, exporter, postgres, papertrail, relic, mezmo, logdna, chronicle, unstructured, elasticsearch, doris, databricks, zerobus, databend, console, clickhouse, blackhole, monitor, ingestion, blob, axiom, sns, streams, appsignal, throttle, cardinality, sample, lua, incremental, exclusive, dedupe, ec2, aggregate, vrl, stdin, scrape, pushgateway, postgresql, okta, nginx, mongodb, logstash, journald, heroku, logplex, fluent, exec, eventstoredb, dnstap, demo, ecs, expressions, functions, language, pgo, optimization, validating, management, runtime, sizing, planning, rollout, availability, hardening, architecting, unified, aggregator, architectures, production, topologies, roles, installer, archives, manual, ubuntu, rhel, raspbian, nixos, macos, debian, centos, arch, amazon, operating, platforms, yum, rpm, pacman, nix, msi, homebrew, helm, dpkg, apt, managers, quickstart, introduction, navbar, dropdown, menu, search, toggle, dark, documentation,
Text of the page (random words):
are value of tags are displayed with the metric when set to full all metric tags are exposed as separate assignments relevant when codec json or codec text enum options option description full all tags are exposed as arrays of either string or null values single tag values are exposed as single strings the same as they were before this config option tags with multiple values show the last assigned value and null values are ignored default single encoding only_fields optional string list of fields that are included in the encoded event encoding protobuf required object options for the protobuf serializer relevant when codec protobuf encoding protobuf desc_file required string literal the path to the protobuf descriptor set file this file is the output of protoc i include path o desc output path proto you can read more here examples etc vector protobuf_descriptor_set desc encoding protobuf message_type required string literal the name of the message type to use for serializing examples package message encoding protobuf use_json_names optional bool use json field names camelcase instead of protobuf field names snake_case when enabled the serializer looks for fields using their json names as defined in the proto file for example jobdescription instead of job_description this is useful when working with data that has already been converted from json or when interfacing with systems that use json naming conventions default false encoding syslog optional object options for the syslog serializer relevant when codec syslog encoding syslog app_name optional string literal path to a field in the event to use for the app name if not provided the encoder checks for a semantic service field if that is also missing it defaults to vector encoding syslog facility optional string literal path to a field in the event to use for the facility defaults to user encoding syslog msg_id optional string literal path to a field in the event to use for the msg id encoding syslog proc_id optional string literal path to a field in the event to use for the proc id encoding syslog rfc optional string literal enum rfc to use for formatting enum options option description rfc3164 the legacy rfc3164 syslog format rfc5424 the modern rfc5424 syslog format default rfc5424 encoding syslog severity optional string literal path to a field in the event to use for the severity defaults to informational encoding timestamp_format optional string literal enum format used for timestamp fields enum options option description rfc3339 represent the timestamp as a rfc 3339 timestamp unix represent the timestamp as a unix timestamp unix_float represent the timestamp as a unix timestamp in floating point unix_ms represent the timestamp as a unix timestamp in milliseconds unix_ns represent the timestamp as a unix timestamp in nanoseconds unix_us represent the timestamp as a unix timestamp in microseconds framing optional object framing configuration framing character_delimited required object options for the character delimited encoder relevant when method character_delimited framing character_delimited delimiter required ascii_char the ascii 7 bit character that delimits byte sequences framing length_delimited required object options for the length delimited decoder relevant when method length_delimited framing length_delimited length_field_is_big_endian optional bool length field byte order little or big endian default true framing length_delimited length_field_length optional uint number of bytes representing the field length default 4 framing length_delimited length_field_offset optional uint number of bytes in the header before the length field framing length_delimited max_frame_length optional uint maximum frame length default 8 388608e 06 framing max_frame_length optional uint maximum frame length relevant when method varint_length_delimited default 8 388608e 06 framing method required string literal enum the framing method enum options option description bytes event data is not delimited at all character_delimited event data is delimited by a single ascii 7 bit character length_delimited event data is prefixed with its length in bytes the prefix is a 32 bit unsigned integer little endian newline_delimited event data is delimited by a newline lf character varint_length_delimited event data is prefixed with its length in bytes as a varint this is compatible with protobuf s length delimited encoding examples bytes character_delimited length_delimited newline_delimited varint_length_delimited healthcheck optional object healthcheck configuration healthcheck enabled optional bool whether or not to check the health of the sink when vector starts up default true healthcheck uri optional string literal the full uri to make http healthcheck requests to this must be a valid uri which requires at least the scheme and host all other components port path etc are allowed as well inputs required string a list of upstream source or transform ids wildcards are supported see configuration for more info array string literal examples my source or transform id prefix method optional string literal enum the http method to use when making the request enum options string literal option description delete delete get get head head options options patch patch post post put put trace trace default post payload_prefix optional string literal a string to prefix the payload with this option is ignored if the encoding is not character delimited json if specified the payload_suffix must also be specified and together they must produce a valid json object examples data payload_suffix optional string literal a string to suffix the payload with this option is ignored if the encoding is not character delimited json if specified the payload_prefix must also be specified and together they must produce a valid json object examples proxy optional object proxy configuration configure to proxy traffic through an http s proxy when making external requests similar to common proxy configuration convention you can set different proxies to use based on the type of traffic being proxied you can also set specific hosts that should not be proxied proxy enabled optional bool enables proxying support default true proxy http optional string literal proxy endpoint to use when proxying http traffic must be a valid uri string examples http foo bar 3128 proxy https optional string literal proxy endpoint to use when proxying https traffic must be a valid uri string examples http foo bar 3128 proxy no_proxy optional string a list of hosts to avoid proxying multiple patterns are allowed pattern example match domain names example com matches requests to example com wildcard domains example com matches requests to example com and its subdomains ip addresses 127 0 0 1 matches requests to 127 0 0 1 cidr blocks 192 168 0 0 16 matches requests to any ip addresses in this range splat matches all hosts request optional object outbound http request settings request adaptive_concurrency optional object configuration of adaptive concurrency parameters these parameters typically do not require changes from the default and incorrect values can lead to meta stable or unstable performance and sink behavior proceed with caution request adaptive_concurrency decrease_ratio optional float the fraction of the current value to set the new concurrency limit when decreasing the limit valid values are greater than 0 and less than 1 smaller values cause the algorithm to scale back rapidly when latency increases note the new limit is rounded down after applying this ratio default 0 9 request adaptive_concurrency ewma_alpha optional float the weighting of new measurements compared to older measurements valid values are greater than 0 and less than 1 arc uses an exponentially weighted moving average ewma of past rtt measurements as a reference to compare with the current rtt smaller values cause this reference to adjust more slowly which may be useful if a service has unusually high response variability default 0 4 request adaptive_concurrency initial_concurrency optional uint the initial concurrency limit to use if not specified the initial limit is 1 no concurrency datadog recommends setting this value to your service s average limit if you re seeing that it takes a long time to ramp up adaptive concurrency after a restart you can find this value by looking at the adaptive_concurrency_limit metric default 1 request adaptive_concurrency max_concurrency_limit optional uint the maximum concurrency limit the adaptive request concurrency limit does not go above this bound this is put in place as a safeguard default 200 request adaptive_concurrency rtt_deviation_scale optional float scale of rtt deviations which are not considered anomalous valid values are greater than or equal to 0 and reasonable values range from 1 0 to 3 0 when calculating the past rtt average a secondary deviation value is also computed that indicates how variable those values are that deviation is used when comparing the past rtt average to the current measurements so we can ignore increases in rtt that are within an expected range this factor is used to scale up the deviation to an appropriate range larger values cause the algorithm to ignore larger increases in the rtt default 2 5 request concurrency optional string literal enum uint configuration for outbound request concurrency this can be set either to one of the below enum values or to a positive integer which denotes a fixed concurrency limit enum options option description adaptive concurrency is managed by vector s adaptive request concurrency feature none a fixed concurrency of 1 only one request can be outstanding at any given time default adaptive request headers optional object additional http headers to add to every http request request headers required string literal an http request header and its value both header names and values support templating with event data examples accept text plain x event level level x event timestamp timestamp x my custom header a value request rate_limit_duration_secs optional uint the time window used for the rate_limit_num option default 1 seconds request rate_limit_num optional uint the maximum number of requests allowed within the rate_limit_duration_secs time window default 9 223372036854776e 18 requests request retry_attempts optional uint the maximum number of retries to make for failed requests default 9 223372036854776e 18 retries request retry_initial_backoff_secs optional uint the amount of time to wait before attempting the first retry for a failed request after the first retry has failed the fibonacci sequence is used to select future backoffs default 1 seconds request retry_jitter_mode optional string literal enum the jitter mode to use for retry backoff behavior enum options option description full full jitter the random delay is anywhere from 0 up to the maximum current delay calculated by the backoff strategy incorporating full jitter into your backoff strategy can greatly reduce the likelihood of creating accidental denial of service dos conditions against your own systems when many clients are recovering from a failure state none no jitter default full request retry_max_duration_secs optional uint the maximum amount of time to wait between retries default 30 seconds request timeout_secs optional uint the time a request can take before being aborted datadog highly recommends that you do not lower this value below the service s internal timeout as this could create orphaned requests pile on retries and result in duplicate data downstream default 60 seconds retry_strategy optional object configurable retry strategy for http based sinks for more information about error responses see client error responses retry_strategy status_codes required uint retry on these specific http status codes relevant when type custom retry_strategy type optional string literal enum the retry strategy enum enum options option description all retry on all http status codes except for success codes 2xx custom custom retry strategy default default strategy see retrystrategy retry_action for more details none don t retry any errors including request timeouts default default tls optional object tls configuration tls alpn_protocols optional string sets the list of supported alpn protocols declare the supported alpn protocols which are used during negotiation with a peer they are prioritized in the order that they are defined tls ca_file optional string literal absolute path to an additional ca certificate file the certificate must be in the der or pem x 509 format additionally the certificate can be provided as an inline string in pem format examples path to certificate_authority crt tls crt_file optional string literal absolute path to a certificate file used to identify this server the certificate must be in der pem x 509 or pkcs 12 format additionally the certificate can be provided as an inline string in pem format if this is set and is not a pkcs 12 archive key_file must also be set examples path to host_certificate crt tls key_file optional string literal absolute path to a private key file used to identify this server the key must be in der or pem pkcs 8 format additionally the key can be provided as an inline string in pem format examples path to host_certificate key tls key_pass optional string literal passphrase used to unlock the encrypted key file this has no effect unless key_file is set examples key_pass_env_var password1 tls server_name optional string literal server name to use when using server name indication sni only relevant for outgoing connections examples www example com tls verify_certificate optional bool enables certificate verification for components that create a server this requires that the client connections have a valid client certificate for components that initiate requests this validates that the upstream has a valid certificate if enabled certificates must not be expired and must be issued by a trusted issuer this verification operates in a hierarchical manner checking that the leaf certificate the certificate presented by the client server is not only valid but that the issuer of that certificate is also valid and so on until the verification process reaches a root certificate do not set this to false unless you understand the risks of not verifying the validity of certificates tls verify_hostname optional bool enables hostname verification if enabled the hostname used to connect to the remote host must be present in the tls certificate presented by the remote host either as the common name or as an entry in the subject alternative name extension only relevant for outgoing connections do not set this to false unless you understand the risks of not verifying the remote hostname uri required string template the full uri to make http requests to this should include the protocol and host but can also include the port path and any other valid part of a uri note ...
|
