Skip to content

Commit

Permalink
Merge pull request #18767 from newrelic/daily-release/9-25-24-midday
Browse files Browse the repository at this point in the history
Daily release/9 25 24 midday
  • Loading branch information
paperclypse authored Sep 25, 2024
2 parents abb2e6e + 4ea6181 commit 69479e9
Show file tree
Hide file tree
Showing 20 changed files with 104 additions and 9 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,20 @@ releaseDate: '2024-09-02'
version: 1.57.0
---

<Callout variant="caution">
**Defective release**: this release has a known issue where process metrics might be reported even if `enable_process_metrics` is undefined or set to `false` in agent settings.
</Callout>

Please consider one of these alternatives:
* Use any version lower than `1.57.0`
* Upgrade to `1.57.2` or later.
* Use `metrics_process_sample_rate: -1` to completely disable process monitoring.


We've released a new version of the agent. Follow standard procedures to [update the Infrastructure agent](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent).
New Relic recommends that you upgrade the agent regularly, every 3 months at a minimum. As of this release, the oldest supported version is [Infrastructure agent 1.47.0](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1470/).

## Changed

* New local health status (/v1/status/health) checks for valid credentials to connect to NR backend [#1908](https://github.com/newrelic/infrastructure-agent/pull/1908)
* Ability to define exclusion lists for process monitoring using the `exclude_matching_metrics` [setting] (https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings/#exclude-matching-metrics) [#1914](https://github.com/newrelic/infrastructure-agent/pull/1914)
* Ability to define exclusion lists for process monitoring using the `exclude_matching_metrics` [setting](https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings/#exclude-matching-metrics) [#1914](https://github.com/newrelic/infrastructure-agent/pull/1914)
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,16 @@ releaseDate: '2024-09-12'
version: 1.57.1
---

<Callout variant="caution">
**Defective release**: this release has a known issue where process metrics might be reported even if `enable_process_metrics` is undefined or set to `false` in agent settings.
</Callout>

Please consider one of these alternatives:
* Use any version lower than `1.57.0`
* Upgrade to `1.57.2` or later.
* Use `metrics_process_sample_rate: -1` to completely disable process monitoring.


We've released a new version of the agent. Follow standard procedures to [update the Infrastructure agent](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent).
New Relic recommends that you upgrade the agent regularly, every 3 months at a minimum. As of this release, the oldest supported version is [Infrastructure agent 1.47.0](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1470/).

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
subject: Infrastructure agent
releaseDate: '2024-09-25'
version: 1.57.2
---

A new version of the agent has been released. Follow standard procedures to [update the infrastructure agent](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent).

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is [Infrastructure agent 1.47.1](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1471/).

## Fixed

* Process metrics are being sent even if `enable_process_metrics` is undefined or defined as `false` [#1927](https://github.com/newrelic/infrastructure-agent/pull/1927)
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,9 @@ New Relic asigna log de OTLP al tipo de datos `Log`. La siguiente tabla describe

### Notas a pie de tabla [#otlp-mapping-notes]

**\[1]** En caso de conflicto en el atributo de recurso, el atributo de alcance, el atributo de registro log , los campos de registro log de nivel superior y el atributo analizado de `LogRecord.body` **\[3]**, el orden del precedente (de mayor a menor) es: atributo analizado de `LogRecord.body` -> campos de nivel superior `LogRecord.*` > `LogRecord.attributes` > `ScopeLogs.InstrumentationScope.attributes` > `ResourceLogs.Resource.attributes`.
**\[1]** En caso de conflicto en el atributo de recurso, el atributo de alcance, el atributo de registro log , los campos de registro log de nivel superior y el atributo analizado de `LogRecord.body` **\[3]**, el orden del precedente (de mayor a menor) es: atributo analizado de `LogRecord.body` -&amp;gt; campos de nivel superior `LogRecord.*` &amp;gt; `LogRecord.attributes` &amp;gt; `ScopeLogs.InstrumentationScope.attributes` &amp;gt; `ResourceLogs.Resource.attributes`.

Consulta [los tipos de atributos OTLP](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types) para obtener detalles sobre los tipos de atributos compatibles con OTLP extremo New Relic .

**\[2]** Si `LogRecord.time_unix_nanos` no está presente, `timestamp` se establece en la hora en que New Relic recibió los datos.

Expand All @@ -204,4 +206,4 @@ Log se correlacionan con una traza si `trace.id` y `span.id` atributo se pueden
Para ver el registro registrado en el contexto de una traza particular, tiene dos opciones:

* Navegue a la pestaña de **Logs** dentro de la [página de detalles de la traza](/docs/distributed-tracing/ui-data/trace-details/#view-your-logs).
* Navegue a la [página de registro](/docs/logs/ui-data/use-logs-ui/) de un servicio y haga clic en un log para abrir los detalles log. Si está asociado a una traza, podrás navegar desde los **Log details** hasta los **Trace details**.
* Navegue a la [página de registro](/docs/logs/ui-data/use-logs-ui/) de un servicio y haga clic en un log para abrir los detalles log. Si está asociado a una traza, podrás navegar desde los **Log details** hasta los **Trace details**.
Original file line number Diff line number Diff line change
Expand Up @@ -351,6 +351,8 @@ New Relic asigna OTLP métrica al [tipo de datos`Metric` ](/docs/data-apis/under

**\[1]**: En caso de conflicto en los campos atributo de recurso, atributo alcance, atributo punto métrico y campos métricos de nivel superior, el orden de precedente (de mayor a menor) es: campos `Metric.*` de nivel superior &amp;gt; `Metric.*.data_points.attributes` &amp;gt; `ScopeMetrics.InstrumentationScope.attributes` &amp;gt; `ResourceMetrics.Resource.attributes`.

Consulta [los tipos de atributos OTLP](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types) para obtener detalles sobre los tipos de atributos compatibles con OTLP extremo New Relic .

### Métrica OTLP sum [#otlp-sum]

OTLP [suma métrica](https://github.com/open-telemetry/opentelemetry-proto/blob/a05597bff803d3d9405fcdd1e1fb1f42bed4eb7a/opentelemetry/proto/metrics/v1/metrics.proto#L217-L226) representa la suma de medidas a lo largo del tiempo. Las sumas incluyen un campo [`aggregation_temporality`](#aggregation-temporality) y un campo `is_monotonic` , que indica si los valores aumentan monótonamente (es decir, solo pueden subir) o no (es decir, pueden subir y bajar). La siguiente tabla describe cómo New Relic trata las diferentes variedades de suma:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,8 @@ New Relic asigna extensiones de OTLP al tipo de datos `Span`. La siguiente tabla

**\[1]** En caso de conflicto en los campos atributo de recurso, atributo de alcance, atributo span y span de nivel superior, el orden de precedente (de mayor a menor) es: campos `Span.*` de nivel superior &amp;gt; `Span.attributes` &amp;gt; `ScopeSpans.InstrumentationScope.attributes` &amp;gt; `ResourceSpans.Resource.attributes`.

Consulta [los tipos de atributos OTLP](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types) para obtener detalles sobre los tipos de atributos compatibles con OTLP extremo New Relic .

## Soporte de enlaces de extensión [#span-links-support]

Actualmente, New Relic no admite [enlaces de tramo](https://opentelemetry.io/docs/concepts/signals/traces/#span-links) de OpenTelemetry.
Original file line number Diff line number Diff line change
Expand Up @@ -269,6 +269,16 @@ El mecanismo para configurar el extremo variará, pero los SDK del lenguaje Open

New Relic emplea [la versión OTLP v0.18.0](https://github.com/open-telemetry/opentelemetry-proto/releases/tag/v0.18.0). Se admiten versiones posteriores, pero aún no se han implementado nuevas funciones. Las características experimentales que ya no están disponibles en 0.18.0 no son compatibles.

## Tipos de atributos OTLP [#otlp-attribute-types]

Los atributos son un concepto recurrente en OpenTelemetry y OTLP. OpenTelemetry tiene una definición [de atributo estándar](https://opentelemetry.io/docs/specs/otel/common/#standard-attribute) , que establece que los valores de los atributos son primitivos (cadena, booleano, punto flotante doble, entero de 64 bits) o una matriz homogénea de primitivos. Sin embargo, en el nivel del protocolo OTLP, los atributos se representan empleando una definición [`AnyValue`](https://github.com/open-telemetry/opentelemetry-proto/blob/4f69356d853029975649c3f38b06fc77d77975fc/opentelemetry/proto/common/v1/common.proto#L28-L40) más amplia. Debido a esto, es posible que los clientes OTLP envíen atributos que no se ajusten a la definición estándar OpenTelemetry .

El extremo OTLP New Relic admite la definición de atributo estándar. No se admiten tipos complejos como mapas de mapas, matrices de objetos y matrices heterogéneas. Los SDK OpenTelemetry solo deben producir datos que se ajusten a la definición de atributo estándar.

<Callout variant="important">
Si bien generalmente se emplea la definición de atributo estándar, los atributos de log son excepcionales y admiten valores complejos (es decir, El tipo de atributo del registro log es [`map<string, any>`](https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-attributes)). A pesar de esto, New Relic actualmente solo admite atributos de registro log que se ajusten a la definición de atributo estándar.
</Callout>

## Carga de respuesta OTLP [#payloads]

Tenga en cuenta los siguientes detalles sobre la carga de respuesta extrema New Relic OTLP:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,9 @@ New Relic は OTLP ログ レコードを`Log`データ型にマッピングし

### 表の脚注 [#otlp-mapping-notes]

**\[1]**リソース属性、スコープ属性、ログレコード属性、最上位ログレコードフィールド、および`LogRecord.body` **\[3]**からの解析された属性に競合がある場合、優先順位(最高から最低)は次のようになります: `LogRecord.body`からの解析された属性 -> 最上位`LogRecord.*`フィールド > `LogRecord.attributes` > `ScopeLogs.InstrumentationScope.attributes` > `ResourceLogs.Resource.attributes`
**\[1]**リソース属性、スコープ属性、ログレコード属性、最上位ログレコードフィールド、および`LogRecord.body` **\[3]**からの解析された属性に競合がある場合、優先順位(最高から最低)は次のようになります: `LogRecord.body`からの解析された属性 -&amp;gt; 最上位`LogRecord.*`フィールド &amp;gt; `LogRecord.attributes` &amp;gt; `ScopeLogs.InstrumentationScope.attributes` &amp;gt; `ResourceLogs.Resource.attributes`

New Relic OTLP エンドポイントでサポートされている属性タイプの詳細については、 [OTLP 属性タイプ](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types)を参照してください。

**\[2]** `LogRecord.time_unix_nanos`が存在しない場合は、 `timestamp` New Relicがデータを受信した時刻に設定されます。

Expand All @@ -204,4 +206,4 @@ New Relic は OTLP ログ レコードを`Log`データ型にマッピングし
特定のトレースのコンテキストで記録されたログを表示するには、次の 2 つのオプションがあります。

* [トレースの詳細ページ](/docs/distributed-tracing/ui-data/trace-details/#view-your-logs) 内の** Logs** \[ログ]タブに移動します。
* サービスの[ログ ページ](/docs/logs/ui-data/use-logs-ui/)に移動し、ログをクリックしてログの詳細を開きます。 トレースに関連付けられている場合は、**Log details**\[ログの詳細]から**Trace details**\[トレースの詳細]に移動できます。
* サービスの[ログ ページ](/docs/logs/ui-data/use-logs-ui/)に移動し、ログをクリックしてログの詳細を開きます。 トレースに関連付けられている場合は、**Log details**\[ログの詳細]から**Trace details**\[トレースの詳細]に移動できます。
Original file line number Diff line number Diff line change
Expand Up @@ -351,6 +351,8 @@ New Relic OTLP メトリクスを[`Metric` データ型](/docs/data-apis/underst

**\[1]** : リソース属性、スコープ属性、メトリクスポイント属性、および最上位のメトリクスフィールドで競合が発生した場合、優先順位(最高から最低)は次のようになります:最上位の`Metric.*`フィールド &amp;gt; `Metric.*.data_points.attributes` &amp;gt; `ScopeMetrics.InstrumentationScope.attributes` &amp;gt; `ResourceMetrics.Resource.attributes`

New Relic OTLP エンドポイントでサポートされている属性タイプの詳細については、 [OTLP 属性タイプ](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types)を参照してください。

### OTLP 合計メトリック [#otlp-sum]

OTLP [合計メトリクスは、](https://github.com/open-telemetry/opentelemetry-proto/blob/a05597bff803d3d9405fcdd1e1fb1f42bed4eb7a/opentelemetry/proto/metrics/v1/metrics.proto#L217-L226)時間の経過に伴う測定値の合計を表します。 合計には、値が単調に増加するか (つまり、上昇のみ可能)、そうでないか (つまり、上昇と下降が可能) を示す[`aggregation_temporality`](#aggregation-temporality)フィールドと`is_monotonic`フィールドが含まれます。 次の表は、New Relic がさまざまな合計の種類をどのように処理するかを示しています。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,8 @@ New Relic は OTLP スパンを`Span`データ型にマッピングします。

**\[1]**リソース属性、スコープ属性、スパン属性、および最上位のスパンフィールドで競合が発生した場合、優先順位(最高から最低)は次のようになります:最上位の`Span.*`フィールド &amp;gt; `Span.attributes` &amp;gt; `ScopeSpans.InstrumentationScope.attributes` &amp;gt; `ResourceSpans.Resource.attributes`

New Relic OTLP エンドポイントでサポートされている属性タイプの詳細については、 [OTLP 属性タイプ](/docs/opentelemetry/best-practices/opentelemetry-otlp/#otlp-attribute-types)を参照してください。

## スパリンクのサポート [#span-links-support]

OpenTelemetry[スパンのリンクは](https://opentelemetry.io/docs/concepts/signals/traces/#span-links)現在 New Relic ではサポートされていません。
Original file line number Diff line number Diff line change
Expand Up @@ -269,6 +269,16 @@ OTLP メトリックス データをNew Relicに送信するには、ヒスト

New Relic は[OTLP リリース v0.18.0](https://github.com/open-telemetry/opentelemetry-proto/releases/tag/v0.18.0)を使用します。 それ以降のバージョンはサポートされていますが、新しい機能はまだ実装されていません。 0.18.0 で利用できなくなった実験的な機能はサポートされていません。

## OTLP 属性タイプ [#otlp-attribute-types]

属性は、OpenTelemetry と OTLP で繰り返し登場する概念です。 OpenTelemetry には[標準の属性](https://opentelemetry.io/docs/specs/otel/common/#standard-attribute)定義があり、属性値はプリミティブ (文字列、ブール値、倍精度浮動小数点数、64 ビット整数) またはプリミティブの同種配列であると規定されています。 ただし、OTLP プロトコル レベルでは、属性はより拡張された[`AnyValue`](https://github.com/open-telemetry/opentelemetry-proto/blob/4f69356d853029975649c3f38b06fc77d77975fc/opentelemetry/proto/common/v1/common.proto#L28-L40)定義を使用して表されます。 このため、OTLP クライアントが OpenTelemetry 標準定義に準拠していない属性を送信する可能性があります。

New Relic OTLP エンドポイントは標準の属性定義をサポートしています。 マップのマップ、オブジェクト配列、異種配列などの複雑な型はサポートされていません。 OpenTelemetry SDK は、標準の属性定義に準拠したデータのみを生成する必要があります。

<Callout variant="important">
標準のプロパティ定義が一般に使用されますが、ログ レコードのプロパティは例外であり、複雑な値をサポートします (つまり、 ログ レコード属性タイプは[`map<string, any>`](https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-attributes)です。 それにもかかわらず、 New Relic現在、標準のプロパティ定義に準拠するログ レコード プロパティのみをサポートしています。
</Callout>

## OTLP 応答ペイロード [#payloads]

New Relic OTLP エンドポイント応答ペイロードに関する次の詳細に注意してください。
Expand Down
Loading

0 comments on commit 69479e9

Please sign in to comment.