# Конфігурація інструментування HTTP

LLMS index: [llms.txt](/llms.txt)

---

## Захоплення заголовків HTTP запитів та відповідей {#capturing-http-request-and-response-headers}

Ви можете налаштувати агент для захоплення попередньо визначених заголовків HTTP як атрибутів відрізка, відповідно до [семантичної домовленості](/docs/specs/semconv/http/http-spans/). Використовуйте наступні властивості для визначення, які заголовки HTTP ви хочете захопити:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.client.capture-request-headers</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_REQUEST_HEADERS</code>
</details>

<span class="label">Description</span>:
Список імен заголовків HTTP, розділених комами. Інструментування HTTP клієнта буде захоплювати значення заголовків HTTP запитів для всіх налаштованих імен заголовків.
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.client.capture-response-headers</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_RESPONSE_HEADERS</code>
</details>

<span class="label">Description</span>:
Список імен заголовків HTTP, розділених комами. Інструментування HTTP клієнта буде захоплювати значення заголовків HTTP відповідей для всіх налаштованих імен заголовків.
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.server.capture-request-headers</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_HEADERS</code>
</details>

<span class="label">Description</span>:
Список імен заголовків HTTP, розділених комами. Інструментування HTTP сервера буде захоплювати значення заголовків HTTP запитів для всіх налаштованих імен заголовків.
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.server.capture-response-headers</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_RESPONSE_HEADERS</code>
</details>

<span class="label">Description</span>:
Список імен заголовків HTTP, розділених комами. Інструментування HTTP сервера буде захоплювати значення заголовків HTTP відповідей для всіх налаштованих імен заголовків.
</div>


Ці параметри конфігурації підтримуються всіма інструментуваннями HTTP клієнта та сервера.

> **Примітка**: Імена властивостей/змінних середовища, наведені в таблиці, все ще є експериментальними та можуть змінюватися.

## Захоплення параметрів запиту сервлета {#capturing-servlet-request-parameters}

Ви можете налаштувати агента для захоплення попередньо визначених параметрів HTTP запиту як атрибутів відрізка для запитів, які обробляються Servlet API. Використовуйте наступну властивість для визначення, які параметри запиту сервлета ви хочете захопити:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.servlet.experimental.capture-request-parameters</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_SERVLET_EXPERIMENTAL_CAPTURE_REQUEST_PARAMETERS</code>
</details>

<span class="label">Description</span>:
Список імен параметрів запиту, розділених комами.
</div>


> **Примітка**: Імена властивостей/змінних середовища, наведені в таблиці, все ще є експериментальними та можуть змінюватися.

## Налаштування відомих методів HTTP {#configuring-known-http-methods}

Налаштовує інструментування для розпізнавання альтернативного набору методів HTTP запиту. Всі інші методи будуть оброблятися як `_OTHER`.

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.known-methods</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS</code>
</details>

<span class="label">Default</span>: CONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACE<br>
<span class="label">Description</span>:
Список відомих методів HTTP, розділених комами.
</div>


## Увімкнення експериментальної телеметрії HTTP {#enabling-experimental-http-telemetry}

Ви можете налаштувати агент для захоплення додаткових експериментальних даних телеметрії HTTP.

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.client.emit-experimental-telemetry</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_CLIENT_EMIT_EXPERIMENTAL_TELEMETRY</code>
</details>

<span class="label">Default</span>: false<br>
<span class="label">Description</span>:
Увімкнення експериментальної телеметрії HTTP клієнта.
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.instrumentation.http.server.emit-experimental-telemetry</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_INSTRUMENTATION_HTTP_SERVER_EMIT_EXPERIMENTAL_TELEMETRY</code>
</details>

<span class="label">Default</span>: false<br>
<span class="label">Description</span>:
Увімкнення експериментальної телеметрії HTTP сервера.
</div>


Для відрізків клієнта та сервера додаються наступні атрибути:

- `http.request.body.size` та `http.response.body.size`: Розмір тіла запиту та відповіді відповідно.

Для метрик клієнта створюються наступні метрики:

- [http.client.request.body.size](/docs/specs/semconv/http/http-metrics/#metric-httpclientrequestbodysize)
- [http.client.response.body.size](/docs/specs/semconv/http/http-metrics/#metric-httpclientresponsebodysize)

Для метрик сервера створюються наступні метрики:

- [http.server.active_requests](/docs/specs/semconv/http/http-metrics/#metric-httpserveractive_requests)
- [http.server.request.body.size](/docs/specs/semconv/http/http-metrics/#metric-httpserverrequestbodysize)
- [http.server.response.body.size](/docs/specs/semconv/http/http-metrics/#metric-httpserverresponsebodysize)
