From 4809ce23ac09e91d2b3e56a26d99426bd3ebb8fd Mon Sep 17 00:00:00 2001 From: svc-docs-eng-opensource-bot Date: Fri, 7 Feb 2025 12:04:51 +0000 Subject: [PATCH] chore: add translations --- .../net-agent-compatibility-requirements.mdx | 20 ++-- .../forward-logs/azure-log-forwarding.mdx | 106 +++++------------- ...opentelemetry-best-practices-resources.mdx | 33 ++++++ .../net-agent-compatibility-requirements.mdx | 24 ++-- .../api-guides/guide-using-ruby-agent-api.mdx | 8 +- .../sending-handled-errors-new-relic.mdx | 8 +- .../third-party-instrumentation.mdx | 66 +++-------- .../monitor-ruby-background-processes.mdx | 42 +++---- .../getting-started/migration-7x-guide.mdx | 2 +- .../getting-started/migration-8x-guide.mdx | 10 +- .../control-when-ruby-agent-starts.mdx | 4 +- .../collect-custom-attributes.mdx | 4 +- .../installation/k8s-agent-operator.mdx | 84 +++++++------- .../forward-logs/azure-log-forwarding.mdx | 104 +++++------------ ...opentelemetry-best-practices-resources.mdx | 33 ++++++ .../net-agent-compatibility-requirements.mdx | 24 ++-- ...ompatibility-requirements-nodejs-agent.mdx | 18 +-- .../api-guides/guide-using-ruby-agent-api.mdx | 8 +- .../sending-handled-errors-new-relic.mdx | 8 +- .../third-party-instrumentation.mdx | 66 +++-------- .../monitor-ruby-background-processes.mdx | 42 +++---- .../getting-started/migration-7x-guide.mdx | 2 +- .../getting-started/migration-8x-guide.mdx | 14 +-- .../control-when-ruby-agent-starts.mdx | 6 +- .../collect-custom-attributes.mdx | 4 +- .../installation/k8s-agent-operator.mdx | 84 +++++++------- .../forward-logs/azure-log-forwarding.mdx | 104 +++++------------ ...opentelemetry-best-practices-resources.mdx | 33 ++++++ .../net-agent-compatibility-requirements.mdx | 24 ++-- ...ompatibility-requirements-nodejs-agent.mdx | 18 +-- .../api-guides/guide-using-ruby-agent-api.mdx | 6 +- .../sending-handled-errors-new-relic.mdx | 8 +- .../third-party-instrumentation.mdx | 66 +++-------- .../monitor-ruby-background-processes.mdx | 40 +++---- .../getting-started/migration-7x-guide.mdx | 2 +- .../getting-started/migration-8x-guide.mdx | 16 +-- .../control-when-ruby-agent-starts.mdx | 6 +- .../collect-custom-attributes.mdx | 4 +- .../installation/k8s-agent-operator.mdx | 84 +++++++------- .../forward-logs/azure-log-forwarding.mdx | 104 +++++------------ ...opentelemetry-best-practices-resources.mdx | 33 ++++++ 41 files changed, 592 insertions(+), 780 deletions(-) diff --git a/src/i18n/content/es/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx b/src/i18n/content/es/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx index e09d6846a22..11cc702484b 100644 --- a/src/i18n/content/es/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx +++ b/src/i18n/content/es/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx @@ -368,7 +368,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum **Microsoft.Data.SqlClient** * Versión mínima admitida: 1.0.19239.1 - * Latest verified compatible version: 6.0.1 + * Última versión compatible verificada: 6.0.1 @@ -451,7 +451,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum **MySql.Data** * Versión mínima admitida: 6.10.7 - * Latest verified compatible version: 9.2.0 + * Última versión compatible verificada: 9.2.0 **MySqlConnector** @@ -538,7 +538,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima compatible: 3.5.0 - * Latest verified compatible version: 3.7.405.13 + * Última versión compatible verificada: 3.7.405.13 * Versión mínima del agente requerida: 10.33.0 @@ -827,7 +827,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima soportada: 7.1.0 - * Latest verified compatible version: 8.3.6 + * Última versión compatible verificada: 8.3.6 @@ -841,7 +841,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima compatible: 3.7.0 - * Latest verified compatible version: 3.7.400.86 + * Última versión compatible verificada: 3.7.400.86 @@ -1248,7 +1248,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum **Microsoft.Data.SqlClient** * Versión mínima admitida: 1.0.19239.1 - * Latest verified compatible version: 6.0.1 + * Última versión compatible verificada: 6.0.1 **System.Data** @@ -1316,7 +1316,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum **MySql.Data** * Versión mínima admitida: 6.10.7 - * Latest verified compatible version: 9..0 + * Última versión compatible verificada: 9..0 **MySqlConnector** @@ -1450,7 +1450,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima compatible: 3.5.0 - * Latest verified compatible version: 3.7.405.13 + * Última versión compatible verificada: 3.7.405.13 * Versión mínima del agente requerida: 10.33.0 @@ -1805,7 +1805,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima soportada: 7.1.0 - * Latest verified compatible version: 8.3.6 + * Última versión compatible verificada: 8.3.6 @@ -1819,7 +1819,7 @@ Para el marco y la biblioteca que no se [instrumentan automáticamente](#instrum * Versión mínima compatible: 3.7.0 - * Latest verified compatible version: 3.7.400.86 + * Última versión compatible verificada: 3.7.400.86 diff --git a/src/i18n/content/es/docs/logs/forward-logs/azure-log-forwarding.mdx b/src/i18n/content/es/docs/logs/forward-logs/azure-log-forwarding.mdx index dbc734dc79a..708064be259 100644 --- a/src/i18n/content/es/docs/logs/forward-logs/azure-log-forwarding.mdx +++ b/src/i18n/content/es/docs/logs/forward-logs/azure-log-forwarding.mdx @@ -16,7 +16,7 @@ translationType: machine Si su registro ya se está recopilando en Azure, puede usar nuestras plantillas [Microsoft Azure Resource Manager (ARM)](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/overview) para reenviarlos y enriquecerlos en New Relic. -Reenviar su registro de Azure a New Relic le brindará capacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus datos log . +Reenviar su registro de Azure a New Relic le brindará capacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus datos log . Actualmente ofrecemos dos plantillas ARM para lograr esto: la plantilla basada en EventHub (recomendada) y la plantilla basada en Blob Storage. @@ -35,8 +35,8 @@ Para enviar el registro desde su centro de eventos: Sigue estos pasos: -1. Asegúrate de tener un . -2. Desde **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**, haga clic en **Integrations & Agents** en el menú de navegación izquierdo. +1. Asegúrate de tener un . +2. Desde **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**, haga clic en **Integrations & Agents** en el menú de navegación izquierdo. 3. En la categoría **Logging** , haga clic en el mosaico **Microsoft Azure Event Hub** en la lista de fuentes de datos. 4. Seleccione la cuenta a la que desea enviar el registro y haga clic en **Continue**. 5. Haga clic en **Generate API key** y copie la clave de API generada. @@ -49,7 +49,7 @@ Sigue estos pasos: Tenga en cuenta que la plantilla es idempotente. Puede comenzar a reenviar el registro desde Event Hub y luego volver a ejecutar la misma plantilla para configurar el reenvío [del registro de actividad de la suscripción de Azure](#subscription-activity-logs) completando el paso 10. - + ### Opcional: envíe el registro de actividad de Azure desde su suscripción [#subscription-activity-logs] @@ -88,17 +88,11 @@ En el siguiente ejemplo, demostraremos cómo reenviar el registro de actividad d 2. Navegue hasta su servicio de Kubernetes: - Kubernetes Service Button + Kubernetes Service Button 3. En el menú de la izquierda, seleccione **Monitoring`>`Diagnostic Settings**: - Diagnostic Settings menu + Diagnostic Settings menu 4. Haga clic en **Add diagnostic setting**. @@ -108,10 +102,7 @@ En el siguiente ejemplo, demostraremos cómo reenviar el registro de actividad d 7. En **Destination details**, seleccione **Stream to an event hub** y configure `Event hub namespace`, `Event hub name` y `Event hub policy name`. Si optó por crear un nuevo centro de eventos y un namespace durante el [despliegue de la plantilla ARM](#eventhub-arm-setup), seleccione las siguientes configuraciones creadas automáticamente (el nombre namespace tendrá un sufijo diferente): - Destination details settings + Destination details settings 8. Haga clic en **Save** para comenzar a reenviar su registro Kubernetes a New Relic: @@ -134,8 +125,8 @@ Para enviar los blobs desde un contenedor en su cuenta de almacenamiento, siga e Sigue estos pasos: -1. Asegúrate de tener un . -2. Vaya a **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** y, a la izquierda, haga clic en **Integrations & Agents**. +1. Asegúrate de tener un . +2. Vaya a **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** y, a la izquierda, haga clic en **Integrations & Agents**. 3. En **Logging**, haga clic en el mosaico `Microsoft Azure Blob Storage` . 4. Seleccione la cuenta a la que desea enviar el registro y haga clic en **Continue**. 5. Haga clic en **Generate API key** y copie el **API key** generado. @@ -160,7 +151,7 @@ SELECT * FROM Log Si solo desea consultar el registro procedente de Azure, ejecute la siguiente consulta: ```sql -SELECT * FROM Log where plugin.type='azure' +SELECT * FROM Log WHERE plugin.type = 'azure' ``` ## Resolución de problemas [#troubleshoot] @@ -168,19 +159,11 @@ SELECT * FROM Log where plugin.type='azure' Si tiene problemas al configurar su reenviador de registros, pruebe estos consejos de resolución de problemas: - + Si no aparecen datos después de habilitar nuestras capacidades de administración de logs, siga nuestros [procedimientos estándar de resolución de problemas de logs](/docs/logs/log-management/troubleshooting/no-log-data-appears-ui/). - + La invocación de Azure Functions para reenviar nuestro registro falla en archivos que superan un cierto tamaño (aproximadamente 105 MB). Esto se debe a un error de falta de memoria causado por el hecho de que el enlace Node.js de Azure Functions [no admite la transmisión por secuencias](https://github.com/Azure/azure-functions-host/issues/1361). Este es un problema conocido y no se puede mitigar, excepto reduciendo el tamaño del registro que carga. @@ -200,16 +183,17 @@ Si implementa nuestras plantillas ARM antes de mayo de 2023, modifique su config Si tiene alguna pregunta sobre este aviso, comuníquese con [nuestro equipo de soporte](https://support.newrelic.com). - + Modificar esta configuración es bastante complejo, ya que implica: * Crear otra cuenta de almacenamiento de acceso privado. + * Mover todos los archivos compartidos y blobs a esta nueva cuenta de almacenamiento de acceso privado. + * Creando un extremo privado para la nueva cuenta de almacenamiento de acceso privado. + * Creando registros DNS para el nuevo extremo privado. + * Modificar la configuración de red de la aplicación de funciones en consecuencia. Debido a esta complejidad, le recomendamos volver a implementar nuestra plantilla ARM desde cero en lugar de intentar modificar esta configuración manualmente. @@ -219,82 +203,54 @@ Si tiene alguna pregunta sobre este aviso, comuníquese con [nuestro equipo de s - + 1. Acceda a la cuenta de almacenamiento creada por la plantilla ARM. - 2. En el menú de la izquierda, vaya a **Settings > Configuration**. + 2. En el menú de la izquierda, vaya a **Settings > Configuration**. 3. En **Allow Blob public access**, seleccione **Disabled**. - Disabling public access to the blobs/containers in the Storage account + Disabling public access to the blobs/containers in the Storage account 4. Haga clic en **Save**. - + 1. Acceda a la aplicación de funciones creada por la plantilla ARM. - 2. En el menú de la izquierda, vaya a **Settings > Configuration**. + 2. En el menú de la izquierda, vaya a **Settings > Configuration**. 3. Seleccione la pestaña **General settings** . 4. En **Platform settings**, para **FTP state**, seleccione **Disabled**. - Disabling FTP access to the Function App + Disabling FTP access to the Function App 5. Haga clic en **Save**. - + 1. Acceda a la aplicación de funciones creada por la plantilla ARM. - 2. En el menú de la izquierda, vaya a **Settings > Configuration**. + 2. En el menú de la izquierda, vaya a **Settings > Configuration**. 3. Seleccione la pestaña **General settings** . 4. En **Platform settings**, para **HTTPS Only**, seleccione **On**. - Enforcing HTTPS to the Function App + Enforcing HTTPS to the Function App 5. Haga clic en **Save**. - + 1. Acceda a la aplicación de funciones creada por la plantilla ARM. - 2. En el menú de la izquierda, vaya a **Settings > Networking**. + 2. En el menú de la izquierda, vaya a **Settings > Networking**. 3. Dentro del cuadro **Inbound Traffic** , haga clic en **Access restriction**. - Disabling public network access to the Function App + Disabling public network access to the Function App 4. En **App access**, desmarque la casilla de verificación **Allow public access** . @@ -308,8 +264,8 @@ Explore los datos de logging en su plataforma con nuestra [UI de logs](/docs/log * Obtenga una visibilidad más profunda de los datos de rendimiento de su aplicación y de su plataforma reenviando su log con nuestras capacidades [de logs en el contexto](/docs/logs/enable-log-management-new-relic/configure-logs-context/configure-logs-context-apm-agents/) . * Configurar [alerta](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-alert-conditions/). -* [Consulta tus datos](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/) y [crea un panel](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/). +* [Consulta tus datos](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/) y [crea un dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/). ## Desactivar reenvío de logs [#disable] -Para deshabilitar las capacidades de reenvío de registros, siga los procedimientos estándar en [la documentación del registro de actividadMicrosoft Azure ](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log). No necesitas hacer nada más en New Relic. +Para deshabilitar las capacidades de reenvío de registros, siga los procedimientos estándar en [la documentación del registro de actividadMicrosoft Azure ](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log). No necesitas hacer nada más en New Relic. \ No newline at end of file diff --git a/src/i18n/content/es/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx b/src/i18n/content/es/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx index 0eff0d9ad15..29fd4ae3df4 100644 --- a/src/i18n/content/es/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx +++ b/src/i18n/content/es/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx @@ -104,6 +104,39 @@ New Relic soporta relaciones entre entidades provenientes de la instrumentación Las relaciones entre un servicio y una entidad host requieren que el servicio incluya el atributo de recurso `host.id` y que coincida con el `host.id` del host en el que se ejecuta. +### Amazon CloudWatch Metric Streams + +Su infraestructura alojada en AWS se puede monitorear con la integración de New Relic con [Amazon CloudWatch Metric Streams](/install/aws-cloudwatch/). Esta no es una solución OpenTelemetry para monitorear su infraestructura. Sin embargo, New Relic admite un serial de relaciones entre los servicios instrumentados OpenTelemetry y la infraestructura monitoreada mediante Amazon CloudWatch Metric Streams. + + + Las relaciones que se describen a continuación aprovechan las convenciones semánticas de OpenTelemetry. Muchas de estas convenciones aún no son estables y todavía están evolucionando. La instrumentación que produce telemetría para el marco siguiente varía en su nivel de madurez y conformidad con las convenciones semánticas. Como tal, la instrumentación que emplee puede no emitir el atributo necesario para que estas relaciones funcionen. Comunicar con los encargados del mantenimiento de la instrumentación que está empleando si tiene alguna pregunta sobre la madurez de la instrumentación con respecto a las convenciones semánticas de OpenTelemetry. + + +#### ElastiCache (Memcached) + +La integración de Amazon CloudWatch Metric Streams para [Elasticache](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-elasticache-monitoring-integration/) genera la entidad ElastiCache en New Relic. Estas entidades tendrán la siguiente etiqueta de entidad: + +* `aws.elasticache.configurationEndpointAddress` o `aws.elasticache.endpointAddress` +* `aws.elasticache.configurationEndpointPort` o `aws.elasticache.endpointPort` + +Si sus servicios emplean instrumentación OpenTelemetry para Memcached debe emitir el siguiente atributo para que se genere una relación: + +* `db.system`:Este atributo debe tener el valor `memcached`. +* `net.peer.name`: Este atributo debe coincidir con la etiqueta de extremo correspondiente de la entidad ElastiCache. +* `net.peer.port`:Este atributo debe coincidir con la etiqueta de puerto correspondiente de la entidad ElastiCache. + +#### Amazon MQ (ActiveMQ) + +La integración de Amazon CloudWatch Metric Streams para [Amazon MQ](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-mq-integration) genera entidades de Amazon MQ en New Relic. Estas entidades tendrán la siguiente etiqueta de entidad: + +* `aws.mq.endpoint` + +Si sus servicios emplean instrumentación OpenTelemetry para ActiveMQ debe tener el siguiente atributo para que se genere una relación: + +* `messaging.system`:Este atributo debe tener el valor `activemq`. +* `server.address`: Este atributo debe coincidir con la etiqueta de extremo correspondiente de la entidad Amazon MQ. +* `span.kind`:Esta relación se genera a partir de datos de intervalo donde `span.kind` es `producer` o `consumer`. + ## Agregar una etiqueta personalizada a una entidad [#tags] Puedes usar etiqueta para organizar y filtrar tu entidad en la UI. [etiqueta](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/) son pares de valores principales, por ejemplo `team: operations`, agregados a varios conjuntos de datos, como aplicaciones de monitoreo y hosts. Ciertos atributos importantes están disponibles automáticamente como etiqueta, como el ID de cuenta; También puedes agregar tu propia etiqueta personalizada [directamente en la UI](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/#add-tags) o con uno de los métodos siguientes. diff --git a/src/i18n/content/jp/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx b/src/i18n/content/jp/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx index 825efe4dd44..04dd8b00b61 100644 --- a/src/i18n/content/jp/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx +++ b/src/i18n/content/jp/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx @@ -368,7 +368,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor **Microsoft.Data.SqlClient** * サポート対象の最小バージョン：1.0.19239.1 - * 最新の検証済み互換バージョン：5.2.1 + * 最新の検証済み互換バージョン: 6.0.1 @@ -451,7 +451,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor **MySql.Data** * サポートされている最小バージョン：6.10.7 - * 最新の検証済み互換バージョン：9.1.0 + * 最新の検証済み互換バージョン: 9.2.0 **MySqlConnector** @@ -538,7 +538,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされる最小バージョン: 3.5.0 - * 最新の検証済み互換バージョン: 3.7.405.5 + * 最新の検証済み互換バージョン: 3.7.405.13 * 必要なエージェントの最小バージョン: 10.33.0 @@ -631,7 +631,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor - 3.7.411.20 + 3.7.412.4 @@ -827,7 +827,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされている最小バージョン：7.1.0 - * 最新の検証済み互換バージョン: 8.3.4 + * 最新の検証済み互換バージョン: 8.3.6 @@ -841,7 +841,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされる最小バージョン: 3.7.0 - * 最新の検証済み互換バージョン: 3.7.400.79 + * 最新の検証済み互換バージョン: 3.7.400.86 @@ -1248,7 +1248,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor **Microsoft.Data.SqlClient** * サポート対象の最小バージョン：1.0.19239.1 - * 最新の検証済み互換バージョン：5.2.1 + * 最新の検証済み互換バージョン: 6.0.1 **System.Data** @@ -1316,7 +1316,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor **MySql.Data** * サポートされている最小バージョン：6.10.7 - * 最新の検証済み互換バージョン：9.1.0 + * 最新の検証済み互換バージョン: 9..0 **MySqlConnector** @@ -1450,7 +1450,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされる最小バージョン: 3.5.0 - * 最新の検証済み互換バージョン: 3.7.405.5 + * 最新の検証済み互換バージョン: 3.7.405.13 * 必要なエージェントの最小バージョン: 10.33.0 @@ -1601,7 +1601,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor - 3.7.411.20 + 3.7.412.4 @@ -1805,7 +1805,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされている最小バージョン：7.1.0 - * 最新の検証済み互換バージョン: 8.3.4 + * 最新の検証済み互換バージョン: 8.3.6 @@ -1819,7 +1819,7 @@ New Relicの .NET エージェントは、.NET フレームワークと .NET Cor * サポートされる最小バージョン: 3.7.0 - * 最新の検証済み互換バージョン: 3.7.400.79 + * 最新の検証済み互換バージョン: 3.7.400.86 diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx index 0b7f555560f..348ac08d405 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx @@ -273,7 +273,7 @@ APMには、任意のカスタムデータを記録する多くの方法が含 - [カスタム イベント](/docs/insights/insights-data-sources/custom-events)を作成します。[`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method)を参照してください。 + [カスタムイベント](/docs/insights/insights-data-sources/custom-events)を作成します。 [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method)を参照してください。 @@ -283,7 +283,7 @@ APMには、任意のカスタムデータを記録する多くの方法が含 - [カスタム属性](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes)を追加します。属性のハッシュを[`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method)に渡します。 + [カスタムアトリビュート](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes)を追加します。 属性のハッシュを[`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method)に渡します。 @@ -293,7 +293,7 @@ APMには、任意のカスタムデータを記録する多くの方法が含 - [カスタム メトリック](/docs/agents/manage-apm-agents/agent-data/custom-metrics)を作成します。[`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method)を参照してください。 + [カスタムメトリック](/docs/agents/manage-apm-agents/agent-data/custom-metrics)を作成します。 [`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method)を参照してください。 @@ -479,4 +479,4 @@ APMには、任意のカスタムデータを記録する多くの方法が含 - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx index 4f616f3a9dc..ebded4102c3 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx @@ -9,7 +9,7 @@ freshnessValidatedDate: never translationType: machine --- -独自のコードで処理しているエラー データをNew Relicに送信するには、エラー ハンドラー内で Ruby エージェントAPI [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method)呼び出しを使用します。 +独自のコードで処理しているエラー データを New Relic に送信するには、エラー ハンドラー内で Ruby エージェントAPI [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method)呼び出しを使用します。 ## New Relicに通知する Ruby [#solution] @@ -103,7 +103,7 @@ NewRelic::Agent.notice_error(exception, options = { }) ⇒ Object エラー発生が適切にグループ化されていませんか？コールバック関数を使用して、独自のエラーフィンガープリントを設定します。 -`Proc`ベースのコールバックをエージェントに提供して、通知された各エラーに目的の[エラーグループ](/docs/errors-inbox/errors-inbox/#how-groups-work)を動的に適用できます。RubyエージェントAPI [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method)を使用して、エージェントにコールバックを提供します。 +`Proc`ベースのコールバックをエージェントに提供して、検出された各エラーに必要な[エラー グループを](/docs/errors-inbox/errors-inbox/#how-groups-work)動的に適用できます。 RubyエージェントAPI [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method)を使用してエージェントにコールバックを提供します。 このAPI呼び出しは、コールバックメソッド（`Proc`型である必要があります）を唯一の引数として扱います。引数は必須です。API呼び出しは、New Relic Rubyエージェントの起動ごとに1回のみ行う必要があるため、Railsの初期化子などに呼び出しを配置できます。APIへの後続の呼び出しが行われると、コールバックメソッドは指定された最新のものに更新されます。以下は、コールバックが定義され、`NewRelic::Agent.set_error_group_callback` APIメソッドに渡される例です。 @@ -212,7 +212,7 @@ NewRelic::Agent.set_error_group_callback(proc) これで、エラーグループの影響を受けるユーザー数を確認できます。 -New Relic RubyエージェントがユーザーIDを認識している場合、トランザクションとエラーをユーザーIDに関連付けることができます。RubyエージェントAPI [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method)を使用して、エージェントにユーザーIDを指定します。 +New Relic Ruby エージェントがユーザー ID を認識している場合は、トランザクションとエラーをそのユーザー ID に関連付けることができます。 RubyエージェントAPI [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method)を使用して、エージェントにユーザー ID を提供します。 このAPI呼び出しには、エンドユーザーの一意の識別子を表す文字列の単一の引数が必要です。この文字列は、UUID、データベースIDなどです。API呼び出しは、トランザクションごとに少なくとも1回実行し、トランザクションを関連付けるユーザーIDをNew Relic Rubyエージェントに通知する必要があります。次に、トランザクションの有効期間中にエージェントがエラーに気付く場合、エラーにはユーザーID値を保持する`enduser.id`エージェント属性が含まれます。 @@ -226,4 +226,4 @@ New Relic RubyエージェントがユーザーIDを認識している場合、 * `NEW_RELIC_METADATA_SERVICE_VERSION` デプロイされたコードのバージョンを含むエラー イベント データに属性`tags.service.version`を追加します。多くの場合、 `1.2.3`などのセマンティック バージョンですが、常にそうであるとは限りません。 * `NEW_RELIC_METADATA_RELEASE_TAG` リリース タグ ( `v0.1.209`や`release-209`など) を含むイベント データに属性`tags.releaseTag`を追加します。 -* `NEW_RELIC_METADATA_COMMIT` コミット sha を含むイベント データに属性`tags.commit`を追加します。 sha 全体を使用することも、最初の 7 文字だけを使用することもできます (例: `734713b` )。 +* `NEW_RELIC_METADATA_COMMIT` コミット sha を含むイベント データに属性`tags.commit`を追加します。 sha 全体を使用することも、最初の 7 文字だけを使用することもできます (例: `734713b` )。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx index 40b83e1dc5e..dcbb8e54aaf 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx @@ -13,7 +13,7 @@ translationType: machine ## サードパーティ製エクステンションの検索 -誰でもRubyエージェント上に構築される gem を作成できます。 New Relic は、これらの拡張機能を追跡し、 Rubyエージェントを構築する他の gem へのリンクを提供するために、 [extends_newrelic_rpm](https://github.com/newrelic/extends_newrelic_rpm)というリポジトリを維持しています。 +誰でもRubyエージェント上に構築される gem を作成できます。 New Relic は、これらの拡張機能を追跡し、 Rubyエージェントを構築する他の gem へのリンクを提供するために、 [extends\_newrelic\_rpm](https://github.com/newrelic/extends_newrelic_rpm)というリポジトリを維持しています。 これらの拡張機能はNewRelicではサポートされて**いません**。 New Relicは、これらのリンクをお客様へのサービスとして収集します。これらのgemに関する問題は、GitHubのそれぞれのプロジェクトに報告する必要があります。 @@ -26,10 +26,7 @@ New Relic では、サードパーティの拡張機能を gem として維持 ライブラリが New Relic で完全なトランザクションとして表現されるべきコードを提供している場合 (たとえば、Ruby エージェントが計測していないウェブリクエストやバックグラウンドジョブなど)、トランザクションを開始するためにこれらのメカニズムのいずれかを使用してください。 - + トランザクションを開始する最も簡単な方法は、メソッドで`add_transaction_tracer`を呼び出すことです。これは、 `NewRelic::Agent::Instrumentation::ControllerInstrumentation`がクラスに含まれていることを前提としています。 ```ruby @@ -45,10 +42,7 @@ New Relic では、サードパーティの拡張機能を gem として維持 ``` - + 場合によっては、New Relic が生成するトランザクションをもう少し制御する必要があります。その場合は、 `perform_action_with_newrelic_trace`を使用できます。オーバーライドできるパラメーターには、トランザクション名とカテゴリ (Web トランザクションかバックグラウンド トランザクションか) が含まれます。 ```ruby @@ -65,7 +59,7 @@ New Relic では、サードパーティの拡張機能を gem として維持 end ``` - パラメータと使用法の詳細については [、perform_action_with_newrelic_trace の完全なドキュメントを](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method) 参照してください。 + 問題と使用法の詳細については、 [perform\_action\_with\_newrelic\_trace の完全なドキュメント](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method)を参照してください。 @@ -74,10 +68,7 @@ New Relic では、サードパーティの拡張機能を gem として維持 メソッドへの呼び出しに関するタイミング情報をNew Relicに追加したい場合がありますが、これは完全なトランザクションを表すものではありません。New Relic では、これを実現するためにメソッドトレーサーを追加することを推奨します。 - + ```ruby require 'new_relic/agent/method_tracer' class Foo @@ -102,10 +93,7 @@ Rubyエージェントは、Datastoresへのコールを記録するための特 `NewRelic::Agent::Datastores`モジュール関数を介して記録されたメトリクスは[、New Relic のデータベース UI に](/docs/apm/applications-menu/monitoring/databases-slow-queries-dashboard)表示されます。 - + `trace` メソッドのデータストアを記録する最も簡単な方法です。 ```ruby @@ -125,10 +113,7 @@ Rubyエージェントは、Datastoresへのコールを記録するための特 このインターフェースで記録されたデータストア メトリックでは、コレクション/テーブル名を追加できないことに注意してください。そのためには、以下の`wrap`メソッドを参照してください。 - + `wrap` メトリック名に追加のコレクション/テーブル情報を使用してデータストア メトリックを記録できます。また、遅いステートメントに気付くなどの操作のためのコールバックも提供します。 ```ruby @@ -162,10 +147,7 @@ Rubyエージェントは、Datastoresへのコールを記録するための特 ``` - + このヘルパー・メソッドは、トランザクション・トレースやスローSQLページで表示するために、遅いSQLクエリを記録します。SQLはユーザーの設定に基づいてフィルタリングされ、難読化されます。 ```ruby @@ -179,10 +161,7 @@ Rubyエージェントは、Datastoresへのコールを記録するための特 - + このヘルパーメソッドは、トランザクショントレースへの遅いデータストア呼び出しのステートメントを記録します。これらは難読化されて**いません**。 ```ruby @@ -202,10 +181,7 @@ Rubyエージェントは、Datastoresへのコールを記録するための特 New Relic を拡張する gem をオーサリングすると、自動テストを書くことができます。エージェント自体が使用するテストヘルパーは、いくつかの一般的なテスト作業を簡略化するために利用できます。 - + このセクションに記載されているテスト メソッドには、テスト コード (通常は`test_helper.rb`ファイル) からこれを呼び出すことでアクセスできます。 ```ruby @@ -213,10 +189,7 @@ New Relic を拡張する gem をオーサリングすると、自動テスト ``` - + この方法は、予想されるメトリクスが Ruby エージェントによって確実に記録されるようにするための主要な方法です。`refute_metrics_recorded`も利用できます。 最も単純な形式では、 `assert_metrics_recorded`は次のように呼び出すことができます。 @@ -234,10 +207,7 @@ New Relic を拡張する gem をオーサリングすると、自動テスト ``` - + これらの方法は、ウェブやバックグラウンドでのトランザクションの実行をシミュレートするものです。 ```ruby @@ -247,10 +217,7 @@ New Relic を拡張する gem をオーサリングすると、自動テスト ``` - + エージェントの構成は、 `with_config`を介してテスト用に変更できます。エージェントの他の構成値に適用されるハッシュを取得します。 ```ruby @@ -264,10 +231,7 @@ New Relic を拡張する gem をオーサリングすると、自動テスト - + 複数のgemバージョンに対して拡張機能をテストする必要がある場合は、Rubyエージェント自身のテストコードの一部であるMultiverseを使うことができます。Multiverse のテスト例は、エージェントファイルの [suites ディレクトリを参照してください](https://github.com/newrelic/newrelic-ruby-agent/tree/master/test/multiverse/suites) 。 自分のgemにMultiverseを設定するには @@ -324,4 +288,4 @@ New Relic を拡張する gem をオーサリングすると、自動テスト * Gem の Multiverse を設定したら、 `rake test:multiverse`を実行してディレクトリでテストを実行します。 - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx index e3e028e3c91..560c80bd2f4 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx @@ -11,7 +11,7 @@ translationType: machine 私たちのRubyエージェントは、いくつかの一般的なバックグラウンドジョブフレームワークを自動的にインストゥルメントしました。 バックグラウンド タスクをトレースするようにカスタマイズすることもできます。 バックグラウンド ジョブからのデータは、APM の[**Transactions**ページ](/docs/apm/applications-menu/monitoring/transactions-page)に**Non-web transactions**として表示されます。 -## 対応フレームワーク [#supported_frameworks] +## 対応フレームワーク [#supported\_frameworks][#supported_frameworks] 最近のRubyエージェントでは、以下のバックグラウンド・ジョブ・フレームワークがデフォルトでサポートされています。 @@ -25,7 +25,7 @@ translationType: machine これらのフレームワークを使用している場合、バックグラウンドジョブの監視には通常、追加の設定は必要ありません。 -## カスタムバックグラウンドジョブの監視 [#custom_background_jobs] +## カスタムバックグラウンドジョブの監視 [#custom\_background\_jobs][#custom_background_jobs] APM [**Transactions** ページ](/docs/apm/applications-menu/monitoring/transactions-page)に **Non-web transactions** として表示されるカスタム バックグラウンド ジョブを計算できます。 サポートされていないフレームワークを使用しながらモニター**Non-web transactions**するには、カスタムインストゥルメンテーションを追加する必要があります。 @@ -52,7 +52,7 @@ APM [**Transactions** ページ](/docs/apm/applications-menu/monitori `:category`に文字列を渡すことはできますが、文字列が`OtherTransaction/`で始まる場合にのみ、値が APM **Transactions**ページに表示されます。 -## カスタムバックグラウンドメソッドの監視 [#custom_methods] +## カスタムバックグラウンドメソッドの監視 [#custom\_methods][#custom_methods] RubyエージェントAPIを使用すると、**Non-web transactions**をトレースするための特定のメソッドを指定できます。 これにより、実行速度が遅いジョブのトレースが収集され、キャプチャされたエラーがトランザクションに関連付けられます。 @@ -93,7 +93,7 @@ RubyエージェントAPIを使用すると、**Non-web transactions** true`オプションを渡します。 +次に、 [`manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic%2FAgent%3Amanual_start)を呼び出して`:sync_startup => true`オプションを渡します。 ```ruby require 'new_relic/agent' @@ -104,31 +104,25 @@ NewRelic::Agent.manual_start(:sync_startup => true) `require 'new_relic/agent'`を使用するにはエージェントのコードが必要であり、手動で起動するまでエージェントが実行されないようにします。 -プロセスがエージェントの[ハーベストサイクル](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle)よりも短い場合は、キューに入れられたすべてのデータが確実に送信されるように、 [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown)を使用してエージェントを手動でシャットダウンする必要があります。 +プロセスがエージェントの[収集サイクル](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle)よりも短い場合は、キューに入れられたすべてのデータが送信されるように、 [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown)を使用してエージェントを手動でシャットダウンする必要があります。 -## バックグラウンドプロセスのためのnewrelic.ymlの設定 [#config_file] +## バックグラウンドプロセスのためのnewrelic.ymlの設定 [#config\_file][#config_file] **newrelic.yml**の構成は、バックグラウンド アプリケーションのコンテキストによって異なります。 - - バックグラウンド アプリがすでにRubyエージェントを実行している非 Rails アプリケーションである場合は、**newrelic.yml** ファイルをバックグラウンド ジョブをリリースするディレクトリまたは **config** サブディレクトリにコピーします。 が含まれていることを確認してください。 + + バックグラウンド アプリがすでにRubyエージェントを実行している非 Rails アプリケーションである場合は、**newrelic.yml** ファイルをバックグラウンド ジョブをリリースするディレクトリまたは **config** サブディレクトリにコピーします。 が含まれていることを確認してください。 Railsコンテキストで実行されないバックグラウンドジョブは、 `NEW_RELIC_ENV`環境変数を調べて、構成ファイルのどのセクションを読み取るかを決定し、 `RUBY_ENV` 、 `RAILS_ENV` 、および`RACK_ENV`環境変数に順番にフォールバックします。これらの環境変数が設定されていない場合、最後にデフォルトで`development`になります。 - + バックグラウンド ジョブが、すでにNew Relicでモニターされている既存の Web アプリケーションのコンテキストで実行される場合、 Rubyエージェントは既存の **newrelic.yml** ファイルを自動的に取得します。 アプリケーションの Rails 環境を起動するバックグラウンド ジョブは、 **newrelic.yml**ファイルのどのセクションを読み取るかを決定するために`RAILS_ENV`環境変数を使用します。 -## 別のアプリケーション名で報告する [#reporting_to_an_alternate_application_name] +## 別のアプリケーション名で報告する [#reporting\_to\_an\_alternate\_application\_name][#reporting_to_an_alternate_application_name] 既存の New Relic Web アプリケーションのコンテキストで実行されるジョブを、APM UI において [異なるアプリケーション名](/docs/apm/new-relic-apm/installation-configuration/naming-your-application) で表示させることができます。 @@ -141,22 +135,16 @@ NewRelic::Agent.manual_start(:sync_startup => true) ./bin/my_background_worker.rb ``` -## エージェントの起動を確認する [#start_agent] +## エージェントの起動を確認する [#start\_agent][#start_agent] Rubyエージェントは、ブラックリストに登録された実行可能ファイル名、rakeタスク名、または定数を検出しない限り、ほとんどの場合、 `require 'newrelic_rpm'`になるとすぐに自動的に起動します。これにより、一般的なレーキタスクやインタラクティブなコンソールセッション中に起動するのを防ぎます。 - + Railsなしで実行されているスタンドアロンスクリプトは、通常、 `require 'newrelic_rpm'`になるとすぐにエージェントを起動します。メインの作業を開始する前にフォークまたはデーモン化するスクリプトがある場合は、初期設定が完了するまでこの`require`呼び出しを延期することをお勧めします。 - + [デーモンgem](https://rubygems.org/gems/daemons)を使用してバックグラウンドタスクを開始すると、Rubyエージェントの開始に失敗し、ログを出力しない場合があります。これは、デーモンgemがバックグラウンドコードを実行する前に作業ディレクトリを`/`に変更するために発生します。次に、エージェントは、ホストプロセスの現在の作業ディレクトリに関連する構成ファイルとログファイルへのパスを解決しようとします。 このような状況でもエージェントを起動できるようにするには、環境変数にエージェントの設定ファイルとログファイルの場所を設定します。 @@ -172,7 +160,7 @@ Rubyエージェントは、ブラックリストに登録された実行可能 詳しくは、 [controlling agent startupに関するドキュメントをご覧ください。](/docs/agents/ruby-agent/troubleshooting/controlling-when-ruby-agent-starts) -## モニタースクリプト [#monitoring_scripts] +## モニタースクリプト [#monitoring\_scripts][#monitoring_scripts] [エージェントの起動手順](#start_agent)は、デーモンでバックグラウンドジョブを実行するときに適用されます。スクリプトが単一のバックグラウンドタスクを実行して終了する場合は、スクリプトの終了時に`::NewRelic::Agent.shutdown`を使用してエージェントを手動でシャットダウンします。これにより、NewRelicコレクターがデータを確実に受信します。例えば： @@ -190,4 +178,4 @@ end SalesOrganization.new.find_new_leads ::NewRelic::Agent.shutdown -``` +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx index 9fd214ae86e..34369bc21f6 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx @@ -151,4 +151,4 @@ Ruby (1.8、1.9 など) の初期の頃、OpenSSL との統合と HTTPS 接続 **Potential issue:** API メソッド`create_distributed_trace_payload`および`accept_distributed_trace_payload`を呼び出すときに、アプリケーション コードでエラーが発生します。 -**Solution:** 代わりに、それぞれ[`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method)と[`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method)を参照してください。 +**Solution:** 代わりに、それぞれ[`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method)と[`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method)を参照してください。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx index ece4184600e..229ae61a9e2 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx @@ -21,7 +21,7 @@ translationType: machine [詳細は、8.0のマイルストーン](https://github.com/newrelic/newrelic-ruby-agent/milestone/10?closed=1) をご覧ください。 -## `add_method_tracer` API メソッドの変更 [#add_method_tracer] +## 変更内容 `add_method_tracer` [#add\_method\_tracer][#add_method_tracer] ### メトリック名のパラメータにProcsを指定すると、文字列が補間されなくなる @@ -81,7 +81,7 @@ add_method_tracer :foo, ['metric1', 'metric2', 'metric3'] このエラーは、テスト環境でMochaのメソッドを呼び出した場合にのみ発生します。しかし、トラブルシューティングの際には、アプリケーションの機能を確認することをお勧めします。 -## Distributed Tracingはデフォルトで有効です。 [#distributed_tracing] +## Distributed Tracingはデフォルトで有効です。 [#distributed\_tracing][#distributed_tracing] `distributed_tracing.enabled`のデフォルトの構成オプションは、バージョン 8.0 以降では true に設定されています。分散トレースを無効にするには、この構成オプションを`newrelic.yml`で false に設定します。 @@ -90,7 +90,7 @@ distributed_tracing: enabled: false ``` -## クロスアプリケーショントレースは非推奨 [#cross_application_tracing] +## クロスアプリケーショントレースは非推奨 [#cross\_application\_tracing][#cross_application_tracing] [Cross Application Tracing](/docs/agents/ruby-agent/features/cross-application-tracing-ruby/) は、8.0では非推奨となっており、将来のリリースで削除される予定です。 @@ -108,7 +108,7 @@ distributed_tracing: ``` -## 非推奨のAPIメソッドとレガシー・インスツルメンテーションの削除 [#removed_deprecated] +## 非推奨のAPIメソッドとレガシー・インスツルメンテーションの削除 [#removed\_deprecated][#removed_deprecated] 以下のメソッドは、以前は非推奨でしたが、現在は削除されています。 @@ -176,4 +176,4 @@ distributed_tracing: - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx index fbe72dcdefa..186046a3250 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx @@ -140,7 +140,7 @@ Ruby エージェントは、起動したくないコンテキストで起動し - [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) API を使用すると、特定のコンテキストでエージェントを起動できます。 構成ファイルで`:agent_enabled`を`false`に設定するか、環境変数`NEW_RELIC_AGENT_ENABLED=false`を設定すると、この API を使用してエージェントを手動で起動できます。 + [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) API を使用すると、特定のコンテキストでエージェントを起動できます。 構成ファイルで`:agent_enabled` `false`に設定するか、環境変数`NEW_RELIC_AGENT_ENABLED=false`を設定すると、この API を使用してエージェントを手動で起動できます。 ```ruby NewRelic::Agent.manual_start(agent_enabled: true) @@ -148,4 +148,4 @@ Ruby エージェントは、起動したくないコンテキストで起動し プロセスが終了する前にエージェントを停止したい場合は、 [`NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#shutdown-instance_method)を呼び出すことができます。 - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx b/src/i18n/content/jp/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx index 0e84b43115d..04102c2c5fb 100644 --- a/src/i18n/content/jp/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx +++ b/src/i18n/content/jp/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx @@ -221,7 +221,7 @@ APM のカスタムアトリビュートを有効にして使用するには、 - Ruby では、カスタム属性の収集がデフォルトで有効になっています。カスタム属性を収集するには、 [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method)メソッドを呼び出します。たとえば、 `@user_id`という名前の変数を記録するには、次のコードを親メソッドに含めます。 + Rubyでは、カスタムアトリビュート コレクションがデフォルトで有効になっています。 カスタムアトリビュートを収集するには、 [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method)メソッドを呼び出します。 たとえば、 `@user_id`という名前の変数を記録するには、親メソッドに次のコードを含めます。 ```ruby ::NewRelic::Agent.add_custom_attributes({ user_id: @user.id }) @@ -247,4 +247,4 @@ APM のカスタムアトリビュートを有効にして使用するには、 ## 合成モニター：カスタム属性を記録する [#synthetics] -[合成モニターのカスタム属性](/docs/synthetics/synthetic-monitoring/scripting-monitors/add-custom-attributes-synthetic-monitoring-data)を参照してください。 +[合成モニターのカスタム属性](/docs/synthetics/synthetic-monitoring/scripting-monitors/add-custom-attributes-synthetic-monitoring-data)を参照してください。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx b/src/i18n/content/jp/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx index 7fd06858746..7f371d12687 100644 --- a/src/i18n/content/jp/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx +++ b/src/i18n/content/jp/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx @@ -96,18 +96,18 @@ kubectl apply -f ./values.yaml -n newrelic ### セレクタの使い方 [#selectors] -インストゥルメンテーション CR がいつAPMエージェントを挿入するかを知るには、セレクターを使用する必要があります。 2 つのラベル セレクターが用意されており、必要に応じて一緒に使用したり (論理 AND (&&) 演算子として機能)、個別に使用したりできます。 +インストゥルメンテーション CR がいつAPMエージェントを挿入するかを知るには、セレクターを使用する必要があります。 ラベル セレクターは 2 つあり、必要に応じて一緒に使用したり (論理 AND ( `&&` ) 演算子として機能します)、個別に使用したりできます。 * `PodLabelSelector` どのポッドをインストゥルメントする必要があるかをAPM自動アタッチに通知します。 `matchLabel`を使用した例 (特定のタグと値を含むポッドを選択): ```yaml - ... - podLabelSelector: - matchLabels: - app.kubernetes.io/name: flask-hello-world - ... + ... + podLabelSelector: + matchLabels: + app.kubernetes.io/name: flask-hello-world + ... ``` * `NameSpaceLabelSelector` ネームスペースレベルで自動インストゥルメントされたポッドを定義します。 @@ -115,13 +115,13 @@ kubectl apply -f ./values.yaml -n newrelic `matchExpressions`を使用した例 (特定のタグと値を含むネームスペースを選択): ```yaml - ... - namespaceLabelSelector: - matchExpressions: - - key: "kubernetes.io/metadata.name" - operator: "In" - values: ["backend"] - ... + ... + namespaceLabelSelector: + matchExpressions: + - key: "kubernetes.io/metadata.name" + operator: "In" + values: ["backend"] + ... ``` @@ -143,14 +143,14 @@ kubectl apply -f ./values.yaml -n newrelic `matchExpressions` Kubernetes のより表現力豊かなラベル セレクターであり、完全一致にしか使用できない`matchLabels`とは異なり、セットベースの一致をサポートします。 `matchLabels`セレクターの有無にかかわらず使用できます。 ```yaml - ... - selector: - matchLabels: - tier: frontend - matchExpressions: - - {key: name, operator: In, values: [payroll, web]} - - {key: environment, operator: NotIn, values: [dev]} - ... + ... + selector: + matchLabels: + tier: frontend + matchExpressions: + - {key: name, operator: In, values: [payroll, web]} + - {key: environment, operator: NotIn, values: [dev]} + ... ``` セレクターにさらに式を追加できます。 例のように、各式にはキー、演算子、および場合によっては (演算子に応じて) 値のリストが含まれている必要があります。 有効な演算子は 4 つあります。 @@ -275,12 +275,12 @@ kubectl apply -f ./values.yaml -n newrelic 次の例をご覧ください: ```yaml - ... - spec: - agent: - language: dotnet - image: newrelic/newrelic-dotnet-init:latest - ... +... +spec: + agent: + language: dotnet + image: newrelic/newrelic-dotnet-init:latest +... ``` ### APM設定 [#apm-config-parameters] @@ -288,15 +288,15 @@ kubectl apply -f ./values.yaml -n newrelic インストゥルメンテーション CR は、 APMエージェントの設定を合理化するために、ポッドに環境変数を挿入する機能を提供します。 次の例をご覧ください: ```yaml - ... - spec: - env: - # Example overriding the appName configuration by using a label of the pod - - name: NEW_RELIC_APP_NAME - valueFrom: - fieldRef: - fieldPath: metadata.labels['app.kubernetes.io/name'] - ... +... +spec: + env: + # Example overriding the appName configuration by using a label of the pod + - name: NEW_RELIC_APP_NAME + valueFrom: + fieldRef: + fieldPath: metadata.labels['app.kubernetes.io/name'] +... ``` 上記の例では、環境変数を使用してエージェント設定をグローバルに構成する方法を示しています。 利用可能な設定オプションについては、各エージェントの設定ドキュメントを参照してください。 @@ -320,8 +320,8 @@ kubectl apply -f ./values.yaml -n newrelic ```bash kubectl create secret generic newrelic-key-secret \ - --namespace my-monitored-namespace \ - --from-literal=new_relic_license_key= + --namespace my-monitored-namespace \ + --from-literal=new_relic_license_key=YOUR_NEW_RELIC_INGEST_LICENSE_KEY ``` * インストゥルメンテーション CR からシークレットを参照するには、次のコマンドを実行します。 @@ -459,9 +459,9 @@ Kubernetes APM 自動アタッチは、必要に応じて[`cert-manager`](https: ```shell helm install cert-manager jetstack/cert-manager \ - --namespace cert-manager \ - --create-namespace \ - --set crds.enabled=true + --namespace cert-manager \ + --create-namespace \ + --set crds.enabled=true ``` * `values.yaml`ファイルで、 `admissionWebhooks.autoGenerateCert.enabled: false`と`admissionWebhooks.certManager.enabled: true`を設定します。 その後、通常どおりチャートをインストールします。 @@ -532,7 +532,7 @@ helm search repo k8s-agents-operator * `podLabelSelector`の使用時に CR による自動インストゥルメンテーションを有効にする必要なラベルがポッドにあることを確認してください。 同様に、CR 内で`namespaceLabelSelector`使用する場合は、ネームスペースに必要なラベルがあることを確認してください。 ```bash - kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' + kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' ``` * APM 自動アタッチ ポッドからログを取得するには、次のコマンドを実行します。 diff --git a/src/i18n/content/jp/docs/logs/forward-logs/azure-log-forwarding.mdx b/src/i18n/content/jp/docs/logs/forward-logs/azure-log-forwarding.mdx index 7e45f608529..6355ef6d588 100644 --- a/src/i18n/content/jp/docs/logs/forward-logs/azure-log-forwarding.mdx +++ b/src/i18n/content/jp/docs/logs/forward-logs/azure-log-forwarding.mdx @@ -16,7 +16,7 @@ translationType: machine ログがすでに Azure に収集されている場合、弊社の [Microsoft Azure Resource Manager (ARM)](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/overview) テンプレートを使用して、New Relic でログを転送し、リッチ化することができます。 -Azure ログをNew Relicに転送すると、ログ データの収集、処理、探索、書き込み、集計の機能が強化されます。 +Azure ログをNew Relicに転送すると、ログ データの収集、処理、探索、書き込み、集計の機能が強化されます。 現在、これを実現するために、EventHubベースのテンプレート（推奨）とBlob Storageベースのテンプレートの2つのARMテンプレートを提供しています。 @@ -35,8 +35,8 @@ Azure ログをNew Relicに転送すると、ログ データの収集、処理 以下の手順に従ってください。 -1. があることを確認してください。 -2. **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**から、左側のナビゲーションにある**Integrations & Agents**をクリックします。 +1. があることを確認してください。 +2. **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**から、左側のナビゲーションにある**Integrations & Agents**をクリックします。 3. **Logging**カテゴリで、データ ソースのリストにある**Microsoft Azure Event Hub**タイルをクリックします。 4. ログを送信するアカウントを選択し、 **Continue**をクリックします。 5. **Generate API key**をクリックして、生成された API キーをコピーします。 @@ -49,7 +49,7 @@ Azure ログをNew Relicに転送すると、ログ データの収集、処理 このテンプレートはべき乗であることに注意してください。Event Hub からログの転送を開始してから、同じテンプレートを再実行して、 [Azure Subscription Activity Logs](#subscription-activity-logs) の転送を設定するには、手順 10 を完了します。 - + ### オプション: サブスクリプションから Azure アクティビティ ログを送信する [#subscription-activity-logs] @@ -88,17 +88,11 @@ Azure ログをNew Relicに転送すると、ログ データの収集、処理 2. Kubernetes サービスに移動します。 - Kubernetes Service Button + Kubernetes Service Button 3. 左側のメニューで、 **Monitoring`>`Diagnostic Settings**を選択します。 - Diagnostic Settings menu + Diagnostic Settings menu 4. **Add diagnostic setting**をクリックします。 @@ -108,10 +102,7 @@ Azure ログをNew Relicに転送すると、ログ データの収集、処理 7. **Destination details**で**Stream to an event hub**を選択し、 `Event hub namespace` 、 `Event hub name` 、 `Event hub policy name`を構成します。 [ARM テンプレートのデプロイメント](#eventhub-arm-setup)中に新しいイベント ハブとネームスペースを作成することを選択した場合は、次の自動的に作成された設定を選択します (ネームスペース名には別のサフィックスが付きます)。 - Destination details settings + Destination details settings 8. **Save**をクリックして、Kubernetes ログを New Relic に転送し始めます。 @@ -134,8 +125,8 @@ Azure ログをNew Relicに転送すると、ログ データの収集、処理 以下の手順に従ってください。 -1. があることを確認してください。 -2. **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)**に移動し、左側の**Integrations & Agents**をクリックします。 +1. があることを確認してください。 +2. **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)**に移動し、左側の**Integrations & Agents**をクリックします。 3. **Logging**の下にある`Microsoft Azure Blob Storage`タイルをクリックします。 4. ログを送信するアカウントを選択し、 **Continue**をクリックします。 5. **Generate API key**をクリックし、生成された**API key**をコピーします。 @@ -160,7 +151,7 @@ SELECT * FROM Log Azureから送られてくるログのみを照会したい場合は、次のようなクエリを実行します。 ```sql -SELECT * FROM Log where plugin.type='azure' +SELECT * FROM Log WHERE plugin.type = 'azure' ``` ## トラブルシューティング [#troubleshoot] @@ -168,19 +159,11 @@ SELECT * FROM Log where plugin.type='azure' ログフォワーダーの設定で問題が発生した場合は、次のトラブルシューティングのヒントを試してください。 - + ログ管理機能を有効にしてもデータが表示されない場合は、[標準のログトラブルシューティング手順](/docs/logs/log-management/troubleshooting/no-log-data-appears-ui/)に従ってください。 - + ログを転送するための Azure Functions 呼び出しは、特定のサイズ (約 105 MB) を超えるファイルでは失敗します。 これは、Azure Functions Node.js バインディングが[ストリーミングをサポートしていない](https://github.com/Azure/azure-functions-host/issues/1361)ために発生するメモリ不足エラーが原因です。 これは既知の問題であり、アップロードするログのサイズを縮小する以外に軽減することはできません。 @@ -200,16 +183,17 @@ SELECT * FROM Log where plugin.type='azure' この通知に関してご質問がある場合は、 [サポート チーム](https://support.newrelic.com)にお問い合わせください。 - + この設定の変更は次のような点で非常に複雑です。 * 別のプライベート アクセス ストレージ アカウントを作成します。 + * すべてのファイル共有と BLOB をこの新しいプライベート アクセス ストレージ アカウントに移動します。 + * 新しいプライベート アクセス ストレージ アカウントのプライベート エンドポイントを作成します。 + * 新しいプライベート エンドポイントの DNS レコードを作成します。 + * それに応じて Function App のネットワーク構成を変更します。 この複雑さのため、この設定を手動で変更するのではなく、ARM テンプレートを最初から再デプロイすることをお勧めします。 @@ -219,82 +203,54 @@ SELECT * FROM Log where plugin.type='azure' - + 1. ARM テンプレートによって作成されたストレージ アカウントにアクセスします。 - 2. 左側のメニューで、 **Settings > Configuration**に移動します。 + 2. 左側のメニューで、 **Settings > Configuration**に移動します。 3. **Allow Blob public access**の下で、 **Disabled**を選択します。 - Disabling public access to the blobs/containers in the Storage account + Disabling public access to the blobs/containers in the Storage account 4. **Save**をクリックします。 - + 1. ARM テンプレートによって作成された Function App にアクセスします。 - 2. 左側のメニューで、 **Settings > Configuration**に移動します。 + 2. 左側のメニューで、 **Settings > Configuration**に移動します。 3. **General settings**タブを選択します。 4. **Platform settings**の下の**FTP state**で、 **Disabled**を選択します。 - Disabling FTP access to the Function App + Disabling FTP access to the Function App 5. **Save**をクリックします。 - + 1. ARM テンプレートによって作成された Function App にアクセスします。 - 2. 左側のメニューで、 **Settings > Configuration**に移動します。 + 2. 左側のメニューで、 **Settings > Configuration**に移動します。 3. **General settings**タブを選択します。 4. **Platform settings**の下の**HTTPS Only**で、 **On**を選択します。 - Enforcing HTTPS to the Function App + Enforcing HTTPS to the Function App 5. **Save**をクリックします。 - + 1. ARM テンプレートによって作成された Function App にアクセスします。 - 2. 左側のメニューで、 **Settings > Networking**に移動します。 + 2. 左側のメニューで、 **Settings > Networking**に移動します。 3. **Inbound Traffic**ボックス内で、 **Access restriction**をクリックします。 - Disabling public network access to the Function App + Disabling public network access to the Function App 4. **App access**で、 **Allow public access**チェックボックスをオフにします。 @@ -312,4 +268,4 @@ SELECT * FROM Log where plugin.type='azure' ## ログ転送を無効にする [#disable] -ログ転送機能を無効にするには、 [Microsoft Azure activity logs documentation](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log) に記載されている標準的な手順に従ってください。New Relic では、他に何もする必要はありません。 +ログ転送機能を無効にするには、 [Microsoft Azure activity logs documentation](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log) に記載されている標準的な手順に従ってください。New Relic では、他に何もする必要はありません。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx b/src/i18n/content/jp/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx index 22e0d8a3277..4d10fc078eb 100644 --- a/src/i18n/content/jp/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx +++ b/src/i18n/content/jp/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx @@ -104,6 +104,39 @@ New Relic OpenTelemetryインストゥルメンテーションからソースさ サービスとホスト エンティティの関係では、サービスに`host.id`リソース属性が含まれ、それが実行されているホストの`host.id`と一致する必要があります。 +### Amazon CloudWatch Metric Streams + +AWSでホストされているインフラストラクチャは、New Relic と[Amazon CloudWatch Metric Streams](/install/aws-cloudwatch/)の統合を使用して監視できます。 これはインフラストラクチャを監視するための OpenTelemetry ソリューションではありません。 ただし、New RelicOpenTelemetry は、Amazon を使用して、 インストゥルメントされたサービスとインフラストラクチャ モニターの間の多数の関係をサポートしています。CloudWatch Metric Streams + + + 以下に説明する関係は、OpenTelemetry のセマンティック規則を活用しています。 これらの規則の多くはまだ安定しておらず、進化し続けています。 以下のフレームワーク用のテレメトリーを生成するインストゥルメンテーションは、成熟度および意味上の規則への準拠のレベルが異なります。 そのため、使用するインストゥルメンテーションは、これらの関係が機能するために必要なプロパティを生成しない可能性があります。 OpenTelemetryのセマンティック規約に関するインストゥルメンテーションの成熟度に関する質問がある場合は、使用しているインストゥルメンテーションのメンテナーにお問い合わせください。 + + +#### ElastiCache (Memcached) + +[Elasticache](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-elasticache-monitoring-integration/) の AmazonCloudWatch Metric Streams インテグレーションは、New Relic で ElastiCache エンティティを生成します。これらのエンティティには次のエンティティ タグが含まれます。 + +* `aws.elasticache.configurationEndpointAddress` または `aws.elasticache.endpointAddress` +* `aws.elasticache.configurationEndpointPort` または `aws.elasticache.endpointPort` + +サービスが Memcached にOpenTelemetry使用する場合、関係を生成するには次のプロパティを発行する必要があります。 + +* `db.system`: この属性の値は`memcached`である必要があります。 +* `net.peer.name`: この属性は、ElastiCache エンティティの対応するエンドポイント タグと一致する必要があります。 +* `net.peer.port`: この属性は、ElastiCache エンティティの対応するポート タグと一致する必要があります。 + +#### Amazon MQ (アクティブMQ) + +[Amazon MQ](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-mq-integration) の AmazonCloudWatch Metric Streams 統合は、New Relic で Amazon MQ エンティティを生成します。これらのエンティティには次のエンティティ タグが含まれます。 + +* `aws.mq.endpoint` + +サービスで ActiveMQ のOpenTelemetryインストゥルメンテーションを使用する場合、関係を生成するには次のプロパティが必要です。 + +* `messaging.system`: この属性の値は`activemq`である必要があります。 +* `server.address`: この属性は、Amazon MQ エンティティの対応するエンドポイント タグと一致する必要があります。 +* `span.kind`: この関係は、 `span.kind`が`producer`または`consumer`であるスパン データから生成されます。 + ## エンティティにカスタムタグを追加する [#tags] タグを使用して、UI 内のエンティティを整理およびフィルターできます。[タグは](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/)、監視対象のアプリやホストなどのさまざまなデータ セットに追加されるキーと値のペア (例: `team: operations`です。アカウント ID など、特定の重要な属性はタグとして自動的に使用可能になります。独自のカスタム タグを[UI に直接](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/#add-tags)追加するか、以下のいずれかの方法を使用して追加することもできます。 diff --git a/src/i18n/content/kr/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx b/src/i18n/content/kr/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx index 82b9f2a2671..694413fc784 100644 --- a/src/i18n/content/kr/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx +++ b/src/i18n/content/kr/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx @@ -368,7 +368,7 @@ translationType: machine **Microsoft.Data.SqlClient** * 지원되는 최소 버전: 1.0.19239.1 - * 최근 검증된 호환 버전: 5.2.1 + * 최신 검증된 호환 버전: 6.0.1 @@ -451,7 +451,7 @@ translationType: machine **MySql.Data** * 지원되는 최소 버전: 6.10.7 - * 최근 검증된 호환 버전: 9.1.0 + * 최신 검증된 호환 버전: 9.2.0 **MySqlConnector** @@ -538,7 +538,7 @@ translationType: machine * 최소 지원 버전: 3.5.0 - * 최신 검증된 호환 버전: 3.7.405.5 + * 최신 검증된 호환 버전: 3.7.405.13 * 필요한 최소 에이전트 버전: 10.33.0 @@ -631,7 +631,7 @@ translationType: machine - 3.7.411.20 + 3.7.412.4 @@ -827,7 +827,7 @@ translationType: machine * 최소 지원 버전: 7.1.0 - * 최신 검증된 호환 버전: 8.3.4 + * 최신 검증된 호환 버전: 8.3.6 @@ -841,7 +841,7 @@ translationType: machine * 최소 지원 버전: 3.7.0 - * 최신 검증된 호환 버전: 3.7.400.79 + * 최신 검증된 호환 버전: 3.7.400.86 @@ -1248,7 +1248,7 @@ translationType: machine **Microsoft.Data.SqlClient** * 지원되는 최소 버전: 1.0.19239.1 - * 최근 검증된 호환 버전: 5.2.1 + * 최신 검증된 호환 버전: 6.0.1 **System.Data** @@ -1316,7 +1316,7 @@ translationType: machine **MySql.Data** * 지원되는 최소 버전: 6.10.7 - * 최근 검증된 호환 버전: 9.1.0 + * 최신 검증된 호환 버전: 9..0 **MySqlConnector** @@ -1450,7 +1450,7 @@ translationType: machine * 최소 지원 버전: 3.5.0 - * 최신 검증된 호환 버전: 3.7.405.5 + * 최신 검증된 호환 버전: 3.7.405.13 * 필요한 최소 에이전트 버전: 10.33.0 @@ -1601,7 +1601,7 @@ translationType: machine - 3.7.411.20 + 3.7.412.4 @@ -1805,7 +1805,7 @@ translationType: machine * 최소 지원 버전: 7.1.0 - * 최신 검증된 호환 버전: 8.3.4 + * 최신 검증된 호환 버전: 8.3.6 @@ -1819,7 +1819,7 @@ translationType: machine * 최소 지원 버전: 3.7.0 - * 최신 검증된 호환 버전: 3.7.400.79 + * 최신 검증된 호환 버전: 3.7.400.86 diff --git a/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index be83166bf2e..5a987d76671 100644 --- a/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -255,20 +255,20 @@ Node.js 에이전트는 [npm(Node Package Manager) 저장소](https://npmjs.org/ | --------------------------------- | ---------- | -------- | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.9.3 | `@newrelic/apollo-server-plugin@1.0.0` | | `@apollo/server` | 4.0.0 | 4.11.3 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.738.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.738.0 | 8.7.1 | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.741.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.741.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@elastic/elasticsearch` | 7.16.0 | 8.17.0 | 11.9.0 | -| `@grpc/grpc-js` | 1.4.0 | 1.12.5 | 8.17.0 | +| `@grpc/grpc-js` | 1.4.0 | 1.12.6 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.3.12 | 9.0.0 | | `@koa/router` | 11.0.2 | 13.1.0 | 3.2.0 | | `@langchain/core` | 0.1.17 | 0.3.37 | 11.13.0 | | `@nestjs/cli` | 9.0.0 | 11.0.2 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.2.0 | 12.10.0 | -| `@prisma/client` | 5.0.0 | 6.3.0 | 11.0.0 | +| `@prisma/client` | 5.0.0 | 6.3.1 | 11.0.0 | | `@smithy/smithy-client` | 2.0.0 | 4.1.3 | 11.0.0 | | `amqplib` | 0.5.0 | 0.10.5 | 2.0.0 | | `apollo-server` | 3.0.0 | 3.13.0 | `@newrelic/apollo-server-plugin@1.0.0` | @@ -287,11 +287,11 @@ Node.js 에이전트는 [npm(Node Package Manager) 저장소](https://npmjs.org/ | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 11.0.2 | 13.0.1 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | -| `mongodb` | 4.1.4 | 6.12.0 | 1.32.0 | +| `mongodb` | 4.1.4 | 6.13.0 | 1.32.0 | | `mysql` | 2.2.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.12.0 | 1.32.0 | | `next` | 13.4.19 | 15.1.6 | 12.0.0 | -| `openai` | 4.0.0 | 4.81.0 | 11.13.0 | +| `openai` | 4.0.0 | 4.82.0 | 11.13.0 | | `pg` | 8.2.0 | 8.13.1 | 9.0.0 | | `pg-native` | 3.0.0 | 3.2.0 | 9.0.0 | | `pino` | 7.0.0 | 9.6.0 | 8.11.0 | diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx index 3c0ac84e27f..3c9bef58136 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx @@ -273,7 +273,7 @@ APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 - [맞춤 이벤트](/docs/insights/insights-data-sources/custom-events) 를 만듭니다. [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method) 을(를) 참조하세요. + [맞춤형 대시보드를](/docs/insights/insights-data-sources/custom-events) 만들어 보세요. [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method) 참조하세요. @@ -283,7 +283,7 @@ APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 - [사용자 정의 속성](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes) 을 추가합니다. 속성의 해시를 [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method) 에 전달합니다. + [사용자 지정 속성을](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes) 추가합니다. [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method) 에 속성 해시를 전달합니다. @@ -293,7 +293,7 @@ APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 - [맞춤 측정항목](/docs/agents/manage-apm-agents/agent-data/custom-metrics) 을 만듭니다. [`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method) 을(를) 참조하세요. + [기본 지표를](/docs/agents/manage-apm-agents/agent-data/custom-metrics) 만듭니다. [`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method) 참조하세요. @@ -479,4 +479,4 @@ APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 - + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx index aeb49788656..d48b0c37b04 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx @@ -9,7 +9,7 @@ freshnessValidatedDate: never translationType: machine --- -자체 코드에서 처리 중인 오류 데이터를 뉴렐릭으로 보내려면 오류 핸들러 내에서 Ruby 에이전트 API [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method) 호출을 사용하세요. +사용자가 직접 코드에서 처리하고 있는 오류 데이터를 뉴렐릭으로 보내려면 오류 처리기 내에서 Ruby 회사 API [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method) 호출을 사용하세요. ## 뉴렐릭에 알림 Ruby [#solution] @@ -103,7 +103,7 @@ NewRelic::Agent.notice_error(exception, options = { }) ⇒ Object 오류 발생이 잘못 그룹화되어 있습니까? 콜백 기능을 통해 나만의 에러 지문을 설정하세요. -`Proc` 기반 콜백을 에이전트에 제공하여 발견된 각 오류에 원하는 [오류 그룹을](/docs/errors-inbox/errors-inbox/#how-groups-work) 동적으로 적용할 수 있습니다. Ruby 에이전트 API [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method) 를 사용하여 에이전트에 콜백을 제공하십시오. +`Proc` 기반 콜백을 에이전트에 제공하여 발견된 각 오류에 원하는 [오류 그룹을](/docs/errors-inbox/errors-inbox/#how-groups-work) 동적으로 적용할 수 있습니다. 에이전트에 콜백을 제공하려면 루비 에이전트 API [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method) 를 사용하세요. 이 API 호출은 콜백 메서드( `Proc`유형이어야 함)를 유일한 인수로 사용합니다. 인수가 필요합니다. API 호출은 New Relic Ruby 에이전트 실행당 한 번만 수행하면 되므로 호출을 Rails 이니셜라이저 또는 유사 항목에 배치할 수 있습니다. API에 대한 후속 호출이 이루어지면 콜백 메서드가 제공된 최신 메서드로 업데이트됩니다. 다음은 콜백이 정의되고 `NewRelic::Agent.set_error_group_callback` API 메서드에 전달되는 예입니다. @@ -212,7 +212,7 @@ NewRelic::Agent.set_error_group_callback(proc) 이제 오류 그룹의 영향을 받는 사용자 수를 볼 수 있습니다. -트랜잭션 및 오류는 New Relic Ruby 에이전트에 알려진 경우 사용자 ID와 연관될 수 있습니다. Ruby 에이전트 API [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method) 를 사용하여 에이전트에 사용자 ID를 제공하십시오. +사용자 ID가 뉴렐릭 루비 에이전트에 알려진 경우 트랜잭션 및 오류가 해당 사용자 ID와 연결될 수 있습니다. 루비 에이전트 API [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method) 를 사용하여 에이전트에 사용자 ID를 제공하세요. 이 API 호출에는 최종 사용자의 고유 식별자를 나타내는 문자열의 단일 인수가 필요합니다. 이 문자열은 UUID, 데이터베이스 ID 또는 이와 유사한 것일 수 있습니다. 트랜잭션과 연결할 사용자 ID를 New Relic Ruby 에이전트에 알리기 위해 트랜잭션당 최소 한 번 API 호출을 수행해야 합니다. 그런 다음 에이전트가 트랜잭션 수명 동안 오류를 발견하면 오류에는 사용자 ID 값을 보유하는 `enduser.id` 에이전트 속성이 포함됩니다. @@ -226,4 +226,4 @@ API는 새 사용자 ID가 범위에 들어올 때마다 호출되도록 되어 * `NEW_RELIC_METADATA_SERVICE_VERSION` 구현하다, 배포하다라는 코드 버전을 포함하는 오류 이벤트 데이터에 `tags.service.version` 속성을 추가합니다. 종종 `1.2.3` 과 같은 의미론적 버전이지만 항상 그런 것은 아닙니다. * `NEW_RELIC_METADATA_RELEASE_TAG` 릴리스 태그(예: `v0.1.209` 또는 `release-209`)가 포함된 이벤트 데이터에 `tags.releaseTag` 속성을 추가합니다. -* `NEW_RELIC_METADATA_COMMIT` 커밋 샤를 포함하는 이벤트 데이터에 `tags.commit` 속성을 추가합니다. 전체 샤를 사용하거나 처음 7자만 사용할 수 있습니다(예: `734713b`). +* `NEW_RELIC_METADATA_COMMIT` 커밋 샤를 포함하는 이벤트 데이터에 `tags.commit` 속성을 추가합니다. 전체 샤를 사용하거나 처음 7자만 사용할 수 있습니다(예: `734713b`). \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx index 508b2f4523f..ba7907bed90 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx @@ -13,7 +13,7 @@ translationType: machine ## 타사 확장 찾기 -누구나 Ruby 에이전트 위에 빌드되는 gem을 작성할 수 있습니다. 뉴렐릭은 이러한 확장을 추적하고 Ruby 에이전트를 구축하는 다른 gem에 대한 링크를 제공하기 위해 [extends_newrelic_rpm](https://github.com/newrelic/extends_newrelic_rpm) 이라는 클러스터를 유지 관리합니다. +누구나 Ruby 에이전트 위에 빌드되는 gem을 작성할 수 있습니다. 뉴렐릭은 이러한 확장을 추적하고 Ruby 에이전트를 구축하는 다른 gem에 대한 링크를 제공하기 위해 [extends\_newrelic\_rpm](https://github.com/newrelic/extends_newrelic_rpm) 이라는 클러스터를 유지 관리합니다. 이러한 확장은 New Relic에서 지원 **되지 않습니다** . New Relic은 이러한 링크를 고객에 대한 서비스로 수집합니다. 이러한 gem과 관련된 문제는 GitHub의 해당 프로젝트에 보고해야 합니다. @@ -26,10 +26,7 @@ New Relic은 계측 라이브러리당 하나의 gem으로 타사 확장을 gem 라이브러리가 New Relic에서 전체 트랜잭션으로 표시되어야 하는 코드를 제공하는 경우(예: Ruby 에이전트에 의해 계측되지 않는 웹 요청 또는 백그라운드 작업) 트랜잭션을 시작하기 위해 이러한 메커니즘 중 하나를 사용하십시오. - + 트랜잭션을 시작하는 가장 간단한 방법은 메서드에서 `add_transaction_tracer` 를 호출하는 것입니다. 이것은 `NewRelic::Agent::Instrumentation::ControllerInstrumentation` 이(가) 클래스에 포함되어 있다고 가정합니다. ```ruby @@ -45,10 +42,7 @@ New Relic은 계측 라이브러리당 하나의 gem으로 타사 확장을 gem ``` - + 때때로 New Relic이 생성하는 트랜잭션을 약간 더 제어해야 합니다. 이 경우 `perform_action_with_newrelic_trace` 을 사용할 수 있습니다. 재정의할 수 있는 일부 매개변수에는 트랜잭션 이름 및 범주(웹 트랜잭션이든 백그라운드 트랜잭션이든)가 포함됩니다. ```ruby @@ -65,7 +59,7 @@ New Relic은 계측 라이브러리당 하나의 gem으로 타사 확장을 gem end ``` - 매개변수 및 사용법에 대한 추가 정보 [는 perform_action_with_newrelic_trace의 전체 문서를](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method) 참조하십시오. + 자세한 파라미터, 변수 및 사용법은 [perform\_action\_with\_newrelic\_trace의 전체 설명서를](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method) 참조하세요. @@ -74,10 +68,7 @@ New Relic은 계측 라이브러리당 하나의 gem으로 타사 확장을 gem 메서드 호출에 대한 타이밍 정보를 New Relic에 추가할 수 있지만 전체 트랜잭션을 나타내지는 않습니다. New Relic은 이를 수행하기 위해 메서드 추적 프로그램을 추가할 것을 권장합니다. - + ```ruby require 'new_relic/agent/method_tracer' class Foo @@ -102,10 +93,7 @@ Ruby 에이전트는 데이터 저장소에 대한 호출을 녹음하기 위한 `NewRelic::Agent::Datastores` 모듈 함수를 통해 기록된 측정 [항목은 New Relic의 Databases UI에](/docs/apm/applications-menu/monitoring/databases-slow-queries-dashboard) 표시됩니다. - + `trace` 메소드에 대한 Datastore를 기록하는 가장 간단한 방법입니다. ```ruby @@ -125,10 +113,7 @@ Ruby 에이전트는 데이터 저장소에 대한 호출을 녹음하기 위한 이 인터페이스로 기록된 Datastore 측정항목은 컬렉션/테이블 이름 추가를 허용하지 않습니다. 이를 위해 아래의 `wrap` 메서드를 참조하세요. - + `wrap` 측정항목 이름에 추가 컬렉션/테이블 정보가 포함된 Datastore 측정항목을 기록할 수 있습니다. 또한 느린 문을 알아차리는 것과 같은 작업에 대한 콜백을 제공합니다. ```ruby @@ -162,10 +147,7 @@ Ruby 에이전트는 데이터 저장소에 대한 호출을 녹음하기 위한 ``` - + 이 도우미 메서드는 트랜잭션 추적 및 느린 SQL 페이지에 표시하기 위해 느린 SQL 쿼리를 기록합니다. SQL은 사용자 설정에 따라 필터링되고 난독화됩니다. ```ruby @@ -179,10 +161,7 @@ Ruby 에이전트는 데이터 저장소에 대한 호출을 녹음하기 위한 - + 이 도우미 메서드는 트랜잭션 추적에 대한 느린 데이터 저장소 호출에 대한 문을 기록합니다. 이것들은 난독화 **되지 않습니다** . ```ruby @@ -202,10 +181,7 @@ Ruby 에이전트는 데이터 저장소에 대한 호출을 녹음하기 위한 New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성할 수 있습니다. 에이전트 자체에서 사용하는 테스트 도우미는 몇 가지 일반적인 테스트 작업을 단순화하는 데 사용할 수 있습니다. - + 이 섹션에 설명된 테스트 메서드는 테스트 코드(가장 일반적으로 `test_helper.rb` 파일)에서 이를 호출하여 액세스할 수 있습니다. ```ruby @@ -213,10 +189,7 @@ New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성 ``` - + 이 방법은 예상 메트릭이 Ruby 에이전트에 의해 기록되도록 하는 기본 방법입니다. `refute_metrics_recorded` 도 사용할 수 있습니다. 가장 간단한 형태로 `assert_metrics_recorded` 은 다음과 같이 호출할 수 있습니다. @@ -234,10 +207,7 @@ New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성 ``` - + 이러한 메서드는 웹 또는 백그라운드 트랜잭션에서 실행을 시뮬레이션합니다. ```ruby @@ -247,10 +217,7 @@ New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성 ``` - + `with_config` 을(를) 통해 테스트를 위해 에이전트 구성을 변경할 수 있습니다. 에이전트의 다른 구성 값에 적용되는 해시를 취합니다. ```ruby @@ -264,10 +231,7 @@ New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성 - + 여러 gem 버전에 대해 확장을 테스트해야 하는 경우 Ruby 에이전트 자체 테스트 코드의 일부인 Multiverse를 사용할 수 있습니다. 다중 우주 테스트의 예 [는 에이전트 파일의 suites 디렉토리를](https://github.com/newrelic/newrelic-ruby-agent/tree/master/test/multiverse/suites) 참조하십시오. 자신의 gem에 대해 Multiverse를 구성하려면: @@ -324,4 +288,4 @@ New Relic을 확장하는 gem을 작성할 때 자동화된 테스트를 작성 * Gem에 대해 Multiverse를 설정한 후 `rake test:multiverse` 을 실행하여 디렉터리에서 테스트를 실행합니다. - + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx index e78cc5bd7b5..86c92e41f49 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx @@ -11,7 +11,7 @@ translationType: machine 우리의 루비 에이전트는 여러 가지 공통 백그라운드 작업 프레임워크를 자동으로 제공합니다. 또한 트레이스의 모든 백그라운드 작업에 맞게 사용자 정의할 수도 있습니다. 백그라운드 작업의 데이터는 APM의 [**Transactions** 페이지](/docs/apm/applications-menu/monitoring/transactions-page) 에 **Non-web transactions** 로 나타납니다. -## 지원되는 프레임워크 [#supported_frameworks] +## 지원되는 프레임워크 [#supported\_frameworks][#supported_frameworks] 다음 백그라운드 작업 프레임워크는 최신 버전의 Ruby 에이전트에서 기본적으로 지원됩니다. @@ -25,7 +25,7 @@ translationType: machine 이러한 프레임워크를 사용하는 경우 일반적으로 백그라운드 작업을 모니터링하는 데 추가 구성이 필요하지 않습니다. -## 사용자 지정 백그라운드 작업 모니터링 [#custom_background_jobs] +## 사용자 지정 백그라운드 작업 모니터링 [#custom\_background\_jobs][#custom_background_jobs] 사용자 정의 백그라운드 작업을 사용하여 APM [**Transactions** 페이지](/docs/apm/applications-menu/monitoring/transactions-page) 에 **Non-web transactions**로 표시할 수 있습니다. 지원되지 않는 프레임워크를 사용하는 동안 **Non-web transactions** 모니터링하려면 로그 소스를 추가해야 합니다. @@ -52,7 +52,7 @@ translationType: machine 문자열을 `:category` 에 전달할 수 있지만 문자열이 `OtherTransaction/` 로 시작하는 경우에만 값이 APM **Transactions** 페이지에 표시됩니다. -## 사용자 정의 백그라운드 방법 모니터링 [#custom_methods] +## 사용자 정의 백그라운드 방법 모니터링 [#custom\_methods][#custom_methods] 루비 에이전트 API 사용하면 **Non-web transactions**를 트레이스할 특정 메소드를 지정할 수 있습니다. 이는 느리게 실행되는 작업에 대한 트레이스를 수집하고 캡처된 오류를 프로세서에 연결합니다. @@ -93,7 +93,7 @@ translationType: machine gem 'newrelic_rpm', require: false ``` -그런 다음 [`manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic%2FAgent%3Amanual_start) 을 호출하고 `:sync_startup => true` 옵션을 전달합니다. +그런 다음 [`manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic%2FAgent%3Amanual_start) 호출하고 `:sync_startup => true` 옵션을 전달합니다. ```ruby require 'new_relic/agent' @@ -104,31 +104,25 @@ NewRelic::Agent.manual_start(:sync_startup => true) `require 'new_relic/agent'` 를 사용하려면 에이전트의 코드가 필요하며 수동으로 시작할 때까지 에이전트가 실행되지 않도록 합니다. -프로세스가 에이전트 [수집 주기](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle) 보다 짧은 경우 대기 중인 모든 데이터가 전송되도록 [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown) 을 사용하여 에이전트를 수동으로 종료해야 합니다. +프로세스가 에이전트 [하베스트 서버](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle) 보다 짧은 경우 대기 중인 모든 데이터가 전송되도록 [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown) 를 사용하여 에이전트를 수동으로 종료해야 합니다. -## 백그라운드 프로세스에 대해 newrelic.yml 구성 [#config_file] +## 백그라운드 프로세스에 대해 newrelic.yml 구성 [#config\_file][#config_file] **newrelic.yml** 구성은 백그라운드 애플리케이션의 컨텍스트에 따라 다릅니다. - - 백그라운드 앱이 이미 루비 에이전트를 실행 중인 Rails가 아닌 앱인 경우, **newrelic.yml** 파일을 백그라운드 작업을 설치한 디렉터리나 **config** 하위 디렉터리에 복사하세요. 포함되어 있는지 확인하세요. + + 백그라운드 앱이 이미 루비 에이전트를 실행 중인 Rails가 아닌 앱인 경우, **newrelic.yml** 파일을 백그라운드 작업을 설치한 디렉터리나 **config** 하위 디렉터리에 복사하세요. 포함되어 있는지 확인하세요. Rails 컨텍스트에서 실행되지 않는 백그라운드 작업은 `NEW_RELIC_ENV` 환경 변수를 검사하여 읽을 구성 파일 섹션을 결정하고, 순서대로 `RUBY_ENV` , `RAILS_ENV` 및 `RACK_ENV` 환경 변수로 폴백합니다. 이러한 환경 변수가 설정되지 않은 경우 마지막으로 기본값은 `development` 입니다. - + 이미 뉴렐릭으로 모니터링되는 기존 웹의 컨텍스트에서 백그라운드 작업이 실행되는 경우 루비 에이전트는 자동으로 기존 **newrelic.yml** 파일을 선택합니다. 애플리케이션의 Rails 환경을 부팅하는 백그라운드 작업은 읽을 **newrelic.yml** 파일의 섹션을 결정하기 위해 `RAILS_ENV` 환경 변수를 사용합니다. -## 대체 애플리케이션 이름으로 보고 [#reporting_to_an_alternate_application_name] +## 대체 애플리케이션 이름으로 보고 [#reporting\_to\_an\_alternate\_application\_name][#reporting_to_an_alternate_application_name] 기존 New Relic 웹 응용 프로그램의 컨텍스트에서 실행되는 작업을 APM UI의 [다른 응용 프로그램 이름](/docs/apm/new-relic-apm/installation-configuration/naming-your-application) 으로 표시할 수 있습니다. @@ -141,22 +135,16 @@ NewRelic::Agent.manual_start(:sync_startup => true) ./bin/my_background_worker.rb ``` -## 에이전트 시작 확인 [#start_agent] +## 에이전트 시작 확인 [#start\_agent][#start_agent] 에이전트가 블랙리스트에 있는 실행 파일 이름, 레이크 작업 이름 또는 상수를 감지하지 않는 한 대부분의 경우 Ruby 에이전트는 `require 'newrelic_rpm'` 하자마자 자동으로 시작됩니다. 이렇게 하면 일반적인 레이크 작업 및 대화형 콘솔 세션 중에 시작되지 않습니다. - + Rails 없이 실행되는 독립 실행형 스크립트는 일반적으로 `require 'newrelic_rpm'` 하자마자 에이전트를 시작합니다. 주요 작업을 시작하기 전에 분기하거나 데몬화하는 스크립트가 있는 경우 초기 설정이 완료될 때까지 이 `require` 호출을 연기할 수 있습니다. - + [daemons gem](https://rubygems.org/gems/daemons) 을 사용하여 백그라운드 작업을 시작하면 Ruby 에이전트가 시작되지 않고 로깅도 내보내지 않을 수 있습니다. 이는 데몬 gem이 백그라운드 코드를 실행하기 전에 작업 디렉토리를 `/` 으로 변경하기 때문에 발생합니다. 그런 다음 에이전트는 호스트 프로세스의 현재 작업 디렉터리를 기준으로 해당 구성 파일 및 로그 파일에 대한 경로를 확인하려고 시도합니다. 이 상황에서 에이전트를 시작하려면 에이전트 구성 파일 및 로그 파일의 위치로 환경 변수를 설정하십시오. 예를 들어: @@ -172,7 +160,7 @@ NewRelic::Agent.manual_start(:sync_startup => true) 자세한 내용은 [에이전트 시작 제어](/docs/agents/ruby-agent/troubleshooting/controlling-when-ruby-agent-starts) 에 대한 설명서를 참조하십시오. -## 스크립트 모니터링 [#monitoring_scripts] +## 스크립트 모니터링 [#monitoring\_scripts][#monitoring_scripts] [에이전트 시작 지침](#start_agent) 은 데몬에서 백그라운드 작업을 실행할 때 적용됩니다. 스크립트가 단일 백그라운드 작업을 실행하고 종료하는 경우 스크립트가 완료되면 `::NewRelic::Agent.shutdown` 를 사용하여 에이전트를 수동으로 종료합니다. 이렇게 하면 New Relic 수집기가 데이터를 수신할 수 있습니다. 예를 들어: @@ -190,4 +178,4 @@ end SalesOrganization.new.find_new_leads ::NewRelic::Agent.shutdown -``` +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx index 23092a35756..627c0cb3518 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx @@ -151,4 +151,4 @@ Ruby 초기(1.8, 1.9 등)에는 OpenSSL과의 통합 및 HTTPS 연결이 제대 **Potential issue:** API 메서드 `create_distributed_trace_payload` 및 `accept_distributed_trace_payload` 호출하는 동안 애플리케이션 코드에서 오류가 발생합니다. -**Solution:** 대신 각각 [`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method) 및 [`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method) 참조하세요. +**Solution:** 대신 각각 [`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method) 및 [`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method) 참조하세요. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx index 1a979b9e780..2f99598dab6 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx @@ -21,7 +21,7 @@ translationType: machine 자세한 내용은 [8.0의 이정표를](https://github.com/newrelic/newrelic-ruby-agent/milestone/10?closed=1) 참조하세요. -## `add_method_tracer` API 메소드 변경사항 [#add_method_tracer] +## 변경 사항 `add_method_tracer` [#add\_method\_tracer][#add_method_tracer] ### 메트릭 이름 매개변수는 Procs를 허용합니다. 더 이상 보간되지 않는 문자열 @@ -81,7 +81,7 @@ add_method_tracer :foo, ['metric1', 'metric2', 'metric3'] 우리는 Mocha 메서드를 호출하는 테스트 환경에서 오류가 발생하는 것을 보았습니다. 그러나 문제 해결 시 응용 프로그램의 기능을 확인하는 것이 좋습니다. -## 분산 추적은 기본적으로 활성화되어 있습니다. [#distributed_tracing] +## 분산 추적은 기본적으로 활성화되어 있습니다. [#distributed\_tracing][#distributed_tracing] `distributed_tracing.enabled` 의 기본 구성 옵션은 버전 8.0 이상에서 true로 설정됩니다. 분산 추적을 비활성화하려면 `newrelic.yml` 에서 이 구성 옵션을 false로 설정하십시오. @@ -90,7 +90,7 @@ distributed_tracing: enabled: false ``` -## 교차 애플리케이션 추적은 더 이상 사용되지 않습니다. [#cross_application_tracing] +## 교차 애플리케이션 추적은 더 이상 사용되지 않습니다. [#cross\_application\_tracing][#cross_application_tracing] [교차 응용 프로그램 추적](/docs/agents/ruby-agent/features/cross-application-tracing-ruby/) 은 8.0에서 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. @@ -108,7 +108,7 @@ distributed_tracing: ``` -## 더 이상 사용되지 않는 API 메서드 및 레거시 계측을 제거했습니다. [#removed_deprecated] +## 더 이상 사용되지 않는 API 메서드 및 레거시 계측을 제거했습니다. [#removed\_deprecated][#removed_deprecated] 다음 메서드는 이전에 더 이상 사용되지 않으며 지금은 제거되었습니다. @@ -142,7 +142,7 @@ distributed_tracing: - [`Tracer#start_external_request_segment`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.start_external_request_segment) API 메소드 + [`Tracer#start_external_request_segment`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.start_external_request_segment) API 메서드 @@ -152,7 +152,7 @@ distributed_tracing: - [`Tracer#in_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.in_transaction) API 메소드 + [`Tracer#in_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.in_transaction) API 메서드 @@ -176,4 +176,4 @@ distributed_tracing: - + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx index 697df1971f6..394ec424036 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx @@ -140,12 +140,12 @@ translationType: machine - [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) API를 사용하여 특정 컨텍스트에서 에이전트를 시작할 수 있습니다. 구성 파일에서 `:agent_enabled` `false` 로 설정하거나 환경 변수를 `NEW_RELIC_AGENT_ENABLED=false` 설정한 경우에도 이 API를 사용하여 에이전트를 수동으로 시작할 수 있습니다. + [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) API는 특정 컨텍스트에서 에이전트를 시작하는 데 사용할 수 있습니다. 구성 파일에서 `:agent_enabled` `false` 로 설정하거나 환경 변수 `NEW_RELIC_AGENT_ENABLED=false` 설정한 경우에도 이 API를 사용하여 수동으로 에이전트를 시작할 수 있습니다. ```ruby NewRelic::Agent.manual_start(agent_enabled: true) ``` - 프로세스가 끝나기 전에 에이전트를 중지하려면 [`NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#shutdown-instance_method) 호출하면 됩니다. + 프로세스가 종료되기 전에 에이전트를 중지하려면 [`NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#shutdown-instance_method) 호출하면 됩니다. - + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx b/src/i18n/content/kr/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx index a94a37bbd75..02e3cad3b73 100644 --- a/src/i18n/content/kr/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx +++ b/src/i18n/content/kr/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx @@ -221,7 +221,7 @@ APM에 대한 사용자 정의 속성을 활성화하고 사용하려면 - Ruby에서는 사용자 정의 속성 컬렉션이 기본적으로 활성화되어 있습니다. 맞춤 속성을 수집하려면 [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method) 메소드를 호출하세요. 예를 들어, `@user_id` 이라는 변수를 기록하려면 상위 메소드에 다음 코드를 포함하십시오. + 사용자 정의 속성 컬렉션은 루비에서 기본적으로 활성화됩니다. 맞춤 속성을 수집하려면 [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method) 메서드를 호출하세요. 예를 들어, `@user_id` 이라는 변수를 기록하려면 부모 메서드에 다음 코드를 포함합니다. ```ruby ::NewRelic::Agent.add_custom_attributes({ user_id: @user.id }) @@ -247,4 +247,4 @@ APM에 대한 사용자 정의 속성을 활성화하고 사용하려면 @@ -143,14 +143,14 @@ kubectl apply -f ./values.yaml -n newrelic `matchExpressions` Kubernetes의 보다 표현력이 뛰어난 레이블 선택기이며 정확한 일치에만 사용할 수 있는 `matchLabels` 과 달리 집합 기반 일치를 지원합니다. `matchLabels` 선택기를 사용하거나 사용하지 않고도 사용할 수 있습니다. ```yaml - ... - selector: - matchLabels: - tier: frontend - matchExpressions: - - {key: name, operator: In, values: [payroll, web]} - - {key: environment, operator: NotIn, values: [dev]} - ... + ... + selector: + matchLabels: + tier: frontend + matchExpressions: + - {key: name, operator: In, values: [payroll, web]} + - {key: environment, operator: NotIn, values: [dev]} + ... ``` 선택기에 더 많은 표현식을 추가할 수 있습니다. 예시에서처럼 각 표현식에는 키, 연산자, 그리고 (연산자에 따라) 값 목록이 포함되어야 합니다. 유효한 연산자는 4개입니다. @@ -275,12 +275,12 @@ kubectl apply -f ./values.yaml -n newrelic 이 예를 보세요: ```yaml - ... - spec: - agent: - language: dotnet - image: newrelic/newrelic-dotnet-init:latest - ... +... +spec: + agent: + language: dotnet + image: newrelic/newrelic-dotnet-init:latest +... ``` ### APM 설정 방법, [#apm-config-parameters] @@ -288,15 +288,15 @@ kubectl apply -f ./values.yaml -n newrelic 로그 CR은 APM 에이전트의 설정을 간소화하기 위해 패드에 환경 변수를 주입하는 기능을 제공합니다. 이 예를 보세요: ```yaml - ... - spec: - env: - # Example overriding the appName configuration by using a label of the pod - - name: NEW_RELIC_APP_NAME - valueFrom: - fieldRef: - fieldPath: metadata.labels['app.kubernetes.io/name'] - ... +... +spec: + env: + # Example overriding the appName configuration by using a label of the pod + - name: NEW_RELIC_APP_NAME + valueFrom: + fieldRef: + fieldPath: metadata.labels['app.kubernetes.io/name'] +... ``` 위의 예에서는 환경 변수를 사용하여 에이전트 설정을 전역적으로 구성하는 방법을 보여드립니다. 사용 가능한 설정 옵션은 각 에이전트의 설정 문서를 참조하세요. @@ -320,8 +320,8 @@ kubectl apply -f ./values.yaml -n newrelic ```bash kubectl create secret generic newrelic-key-secret \ - --namespace my-monitored-namespace \ - --from-literal=new_relic_license_key= + --namespace my-monitored-namespace \ + --from-literal=new_relic_license_key=YOUR_NEW_RELIC_INGEST_LICENSE_KEY ``` * 계측 CR에서 비밀을 참조하려면 다음 명령을 실행하세요. @@ -459,9 +459,9 @@ Kubernetes APM 자동 연결은 원하는 경우 [`cert-manager`](https://github ```shell helm install cert-manager jetstack/cert-manager \ - --namespace cert-manager \ - --create-namespace \ - --set crds.enabled=true + --namespace cert-manager \ + --create-namespace \ + --set crds.enabled=true ``` * `values.yaml` 파일에서 `admissionWebhooks.autoGenerateCert.enabled: false` 및 `admissionWebhooks.certManager.enabled: true` 설정합니다. 그런 다음 평소처럼 차트를 설치합니다. @@ -532,7 +532,7 @@ helm search repo k8s-agents-operator * `podLabelSelector` 사용할 때 CR을 통한 자동 시스템을 활성화하는 데 필요한 레이블이 파드에 있는지 확인하세요. 마찬가지로 CR 내부에서 `namespaceLabelSelector` 사용할 때 네임스페이스에 필요한 레이블이 있는지 확인하세요. ```bash - kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' + kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' ``` * APM 자동 연결 패드에서 로그를 가져오려면 다음 명령을 실행하세요. diff --git a/src/i18n/content/kr/docs/logs/forward-logs/azure-log-forwarding.mdx b/src/i18n/content/kr/docs/logs/forward-logs/azure-log-forwarding.mdx index 2c0c2fd549a..dd3a260f241 100644 --- a/src/i18n/content/kr/docs/logs/forward-logs/azure-log-forwarding.mdx +++ b/src/i18n/content/kr/docs/logs/forward-logs/azure-log-forwarding.mdx @@ -16,7 +16,7 @@ translationType: machine 로그가 이미 Azure에서 수집되고 있는 경우 [Microsoft ARM(Azure Resource Manager)](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/overview) 템플릿을 사용하여 New Relic에서 로그를 전달하고 강화할 수 있습니다. -Azure 로그를 뉴렐릭으로 전달하면 로그 데이터에 대한 수집, 처리, 탐색, 쿼리 및 공지를 위한 향상된 기능이 제공됩니다. +Azure 로그를 뉴렐릭으로 전달하면 로그 데이터에 대한 수집, 처리, 탐색, 쿼리 및 공지를 위한 향상된 기능이 제공됩니다. 이를 달성하기 위해 현재 EventHub 기반(권장) 및 Blob Storage 기반 템플릿의 두 가지 ARM 템플릿을 제공합니다. @@ -35,8 +35,8 @@ Event Hub에서 로그를 보내려면: 이 단계를 따르세요: -1. 있는지 확인하세요. -2. **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)** 의 왼쪽 탐색 메뉴에서 **Integrations & Agents** 클릭합니다. +1. 있는지 확인하세요. +2. **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)** 의 왼쪽 탐색 메뉴에서 **Integrations & Agents** 클릭합니다. 3. **Logging** 카테고리의 데이터 소스 목록에서 **Microsoft Azure Event Hub** 타일을 클릭합니다. 4. 로그를 전송할 계정을 선택하고 **Continue** 클릭합니다. 5. **Generate API key** 클릭하고 생성된 API 키를 복사합니다. @@ -49,7 +49,7 @@ Event Hub에서 로그를 보내려면: 템플릿은 멱등원입니다. Event Hub에서 로그 전달을 시작한 다음 10단계를 완료하여 동일한 템플릿을 다시 실행하여 [Azure 구독 활동 로그](#subscription-activity-logs) 전달을 구성할 수 있습니다. - + ### 선택 사항: 구독에서 Azure 활동 로그 보내기 [#subscription-activity-logs] @@ -88,17 +88,11 @@ Event Hub에서 로그를 보내려면: 2. Kubernetes 서비스로 이동합니다. - Kubernetes Service Button + Kubernetes Service Button 3. 왼쪽 메뉴에서 **Monitoring`>`Diagnostic Settings** 선택합니다. - Diagnostic Settings menu + Diagnostic Settings menu 4. **Add diagnostic setting** 을(를) 클릭합니다. @@ -108,10 +102,7 @@ Event Hub에서 로그를 보내려면: 7. **Destination details** 에서 **Stream to an event hub** 선택하고 `Event hub namespace`, `Event hub name` 및 `Event hub policy name` 를 구성합니다. [ARM 템플릿 구현, 배포](#eventhub-arm-setup) 중에 새 이벤트 허브 및 지우스페이스를 생성하기로 선택한 경우 자동으로 생성된 다음 설정을 선택합니다(지휘스페이스 이름에는 다른 접미사가 있음). - Destination details settings + Destination details settings 8. Kubernetes 로그를 뉴렐릭으로 전달하려면 **Save** 을 클릭하세요. @@ -134,8 +125,8 @@ Event Hub에서 로그를 보내려면: 이 단계를 따르세요: -1. 있는지 확인하세요. -2. **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** 으로 이동하고 왼쪽에서 **Integrations & Agents** 클릭합니다. +1. 있는지 확인하세요. +2. **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** 으로 이동하고 왼쪽에서 **Integrations & Agents** 클릭합니다. 3. **Logging** 아래에서 `Microsoft Azure Blob Storage` 타일을 클릭합니다. 4. 로그를 보낼 계정을 선택하고 **Continue** 클릭합니다. 5. **Generate API key** 클릭하고 생성된 **API key** 을 복사합니다. @@ -160,7 +151,7 @@ SELECT * FROM Log Azure에서 오는 로그만 쿼리하려면 다음 쿼리를 실행합니다. ```sql -SELECT * FROM Log where plugin.type='azure' +SELECT * FROM Log WHERE plugin.type = 'azure' ``` ## 문제점 해결 [#troubleshoot] @@ -168,19 +159,11 @@ SELECT * FROM Log where plugin.type='azure' 로그 전달자를 구성하는 데 문제가 발생하는 경우 다음 문제 해결 팁을 시도해 보십시오. - + 로그 관리 기능을 활성화한 후에도 데이터가 나타나지 않으면 [표준 로그 문제 해결 절차](/docs/logs/log-management/troubleshooting/no-log-data-appears-ui/) 를 따르십시오. - + 특정 크기(약 105MB)를 초과하는 파일의 경우 로그 전달을 위한 Azure Functions 호출이 실패합니다. 이는 Azure Functions Node.js 바인딩이 [스트리밍을 지원하지 않는다는](https://github.com/Azure/azure-functions-host/issues/1361) 사실로 인해 발생하는 메모리 부족 오류 때문입니다. 이는 알려진 문제이며 업로드하는 로그의 크기를 줄이는 것 외에는 완화할 수 없습니다. @@ -200,16 +183,17 @@ SELECT * FROM Log where plugin.type='azure' 이 공지와 관련하여 질문이 있는 경우 [지원 팀](https://support.newrelic.com)에 문의하십시오. - + 이 설정을 수정하는 것은 다음과 같이 매우 복잡합니다. * 다른 프라이빗 액세스 스토리지 계정을 생성합니다. + * 모든 파일 공유 및 Blob을 이 새로운 프라이빗 액세스 스토리지 계정으로 이동합니다. + * 새 프라이빗 액세스 스토리지 계정에 대한 프라이빗 엔드포인트 생성. + * 새 프라이빗 엔드포인트에 대한 DNS 레코드 생성. + * 이에 따라 함수 앱의 네트워크 구성을 수정합니다. 이러한 복잡성으로 인해 이 설정을 수동으로 수정하려고 시도하는 대신 ARM 템플릿을 처음부터 다시 배포하는 것이 좋습니다. @@ -219,82 +203,54 @@ SELECT * FROM Log where plugin.type='azure' - + 1. ARM 템플릿으로 생성된 스토리지 계정에 액세스합니다. - 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. + 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. 3. **Allow Blob public access** 아래에서 **Disabled** 선택합니다. - Disabling public access to the blobs/containers in the Storage account + Disabling public access to the blobs/containers in the Storage account 4. **Save** 을(를) 클릭합니다. - + 1. ARM 템플릿으로 만든 함수 앱에 액세스합니다. - 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. + 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. 3. **General settings** 탭을 선택합니다. 4. **Platform settings** 아래에서 **FTP state** 에 대해 **Disabled** 선택합니다. - Disabling FTP access to the Function App + Disabling FTP access to the Function App 5. **Save** 을(를) 클릭합니다. - + 1. ARM 템플릿으로 만든 함수 앱에 액세스합니다. - 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. + 2. 왼쪽 메뉴에서 **Settings > Configuration** 으로 이동합니다. 3. **General settings** 탭을 선택합니다. 4. **Platform settings** 아래에서 **HTTPS Only** 에 대해 **On** 선택합니다. - Enforcing HTTPS to the Function App + Enforcing HTTPS to the Function App 5. **Save** 을(를) 클릭합니다. - + 1. ARM 템플릿으로 만든 함수 앱에 액세스합니다. - 2. 왼쪽 메뉴에서 **Settings > Networking** 으로 이동합니다. + 2. 왼쪽 메뉴에서 **Settings > Networking** 으로 이동합니다. 3. **Inbound Traffic** 상자 내에서 **Access restriction** 클릭합니다. - Disabling public network access to the Function App + Disabling public network access to the Function App 4. **App access** 아래에서 **Allow public access** 확인란을 선택 취소합니다. @@ -312,4 +268,4 @@ SELECT * FROM Log where plugin.type='azure' ## 로그 전달 사용 안함 [#disable] -로그 전달 기능을 비활성화하려면 [Microsoft Azure 활동 로그 설명서](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log) 의 표준 절차를 따르십시오. New Relic에서는 다른 작업을 수행할 필요가 없습니다. +로그 전달 기능을 비활성화하려면 [Microsoft Azure 활동 로그 설명서](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log) 의 표준 절차를 따르십시오. New Relic에서는 다른 작업을 수행할 필요가 없습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx b/src/i18n/content/kr/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx index a71481fd173..b2ca5788e0f 100644 --- a/src/i18n/content/kr/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx +++ b/src/i18n/content/kr/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx @@ -104,6 +104,39 @@ Redis 서버는 수집기 [Redis 수신기](https://github.com/open-telemetry/op 서비스와 호스트 엔터티 간의 관계에서는 서비스에 `host.id` 리소스 속성이 포함되어야 하고 서비스가 실행 중인 호스트의 `host.id` 과 일치해야 합니다. +### Amazon CloudWatch Metric Streams + +AWS 에서 호스팅되는 뷰는 뉴렐릭이 [Amazon CloudWatch Metric Streams](/install/aws-cloudwatch/) 와 통합되어 모니터링될 수 있습니다. 이는 인프라를 모니터링하기 위한 OpenTelemetry 솔루션이 아닙니다. 그러나 뉴렐릭은 Amazon 사용하여 렌더링된 서비스와 리소스 모니터 간의 다양한 관계를 OpenTelemetry CloudWatch Metric Streams 지원합니다. + + + 아래에 설명된 관계는 OpenTelemetry 의미 규칙을 활용합니다. 이러한 관례들 중 다수는 아직 안정적이지 않으며 계속 발전하고 있습니다. 아래 프레임워크에 대한 프레임메트리를 생성하는 측정, 로그는 의미 규칙에 대한 성숙도 및 준수 수준에 따라 다릅니다. 따라서 귀하가 사용하는 측정 시스템은 이러한 관계가 작동하는 데 필요한 속성을 방출하지 않을 수 있습니다. OpenTelemetry 의 의미 규칙에 따른 계측, 계측의 완성도에 관한 질문이 있으면 사용 중인 계측, 계측의 유지 관리자에게 문의하세요. + + +#### 엘라스티캐시(Memcached) + +CloudWatch Metric Streams [Elasticache](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-elasticache-monitoring-integration/) 용 Amazon 통합은 뉴렐릭에서 ElastiCache 분리를 생성합니다. 이 파티션 태그는 다음과 같습니다: + +* `aws.elasticache.configurationEndpointAddress` 또는 `aws.elasticache.endpointAddress` +* `aws.elasticache.configurationEndpointPort` 또는 `aws.elasticache.endpointPort` + +서비스에서 OpenTelemetry 측정, Memcached용 계측을 사용하는 경우 관계를 생성하려면 다음 속성을 내보내야 합니다. + +* `db.system`: 이 속성은 `memcached` 값을 가져야 합니다. +* `net.peer.name`: 이 속성은 ElastiCache의 해당 부품포인트 태그와 일치해야 합니다. +* `net.peer.port`: 이 속성은 ElastiCache의 해당 포트 태그와 일치해야 합니다. + +#### 아마존 MQ(액티브MQ) + +[Amazon MQ](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-mq-integration) 에 대한 Amazon CloudWatch Metric Streams 통합은 뉴렐릭에서 Amazon MQ 부분을 생성합니다. 이 파티션 태그는 다음과 같습니다: + +* `aws.mq.endpoint` + +서비스에서 OpenTelemetry 측정, ActiveMQ용 계측을 사용하는 경우 관계를 생성하려면 다음 속성이 필요합니다. + +* `messaging.system`: 이 속성은 `activemq` 값을 가져야 합니다. +* `server.address`: 이 속성은 Amazon MQ의 해당 포인트 포인트 태그와 일치해야 합니다. +* `span.kind`: 이 관계는 `span.kind` 이 `producer` 또는 `consumer` 인 범위 데이터에서 생성됩니다. + ## 엔터티에 사용자 정의 태그 추가 [#tags] 태그를 사용하여 UI에서 엔터티를 구성하고 필터링할 수 있습니다. [태그는](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/) 모니터링되는 앱 및 호스트와 같은 다양한 데이터 세트에 추가되는 키-값 쌍(예 `team: operations`)입니다. 특정 중요한 속성은 계정 ID와 같은 태그로 자동으로 제공됩니다. [UI에서 직접](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/#add-tags) 또는 아래 방법 중 하나를 사용하여 나만의 맞춤 태그를 추가할 수도 있습니다. diff --git a/src/i18n/content/pt/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx b/src/i18n/content/pt/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx index 6f9023abafe..c741ce71c01 100644 --- a/src/i18n/content/pt/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx +++ b/src/i18n/content/pt/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx @@ -368,7 +368,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic **Microsoft.Data.SqlClient** * Versão mínima suportada: 1.0.19239.1 - * Última versão compatível verificada: 5.2.1 + * Última versão compatível verificada: 6.0.1 @@ -451,7 +451,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic **MySql.Data** * Versão mínima suportada: 6.10.7 - * Última versão compatível verificada: 9.1.0 + * Última versão compatível verificada: 9.2.0 **MySqlConnector** @@ -538,7 +538,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 3.5.0 - * Última versão compatível verificada: 3.7.405.5 + * Última versão compatível verificada: 3.7.405.13 * Versão mínima do agente necessária: 10.33.0 @@ -631,7 +631,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic - 3.7.411.20 + 3.7.412.4 @@ -827,7 +827,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 7.1.0 - * Última versão compatível verificada: 8.3.4 + * Última versão compatível verificada: 8.3.6 @@ -841,7 +841,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 3.7.0 - * Última versão compatível verificada: 3.7.400.79 + * Última versão compatível verificada: 3.7.400.86 @@ -1248,7 +1248,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic **Microsoft.Data.SqlClient** * Versão mínima suportada: 1.0.19239.1 - * Última versão compatível verificada: 5.2.1 + * Última versão compatível verificada: 6.0.1 **System.Data** @@ -1316,7 +1316,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic **MySql.Data** * Versão mínima suportada: 6.10.7 - * Última versão compatível verificada: 9.1.0 + * Última versão compatível verificada: 9..0 **MySqlConnector** @@ -1450,7 +1450,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 3.5.0 - * Última versão compatível verificada: 3.7.405.5 + * Última versão compatível verificada: 3.7.405.13 * Versão mínima do agente necessária: 10.33.0 @@ -1601,7 +1601,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic - 3.7.411.20 + 3.7.412.4 @@ -1805,7 +1805,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 7.1.0 - * Última versão compatível verificada: 8.3.4 + * Última versão compatível verificada: 8.3.6 @@ -1819,7 +1819,7 @@ Quer experimentar nosso agente .NET? [Crie uma conta New Relic](https://newrelic * Versão mínima suportada: 3.7.0 - * Última versão compatível verificada: 3.7.400.79 + * Última versão compatível verificada: 3.7.400.86 diff --git a/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index cebc351f9f6..9839ff75b39 100644 --- a/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -255,20 +255,20 @@ Após a instalação, o agente automaticamente instrumento com nosso catálogo d | --------------------------------- | ----------------------- | ----------------------- | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.9.3 | `@newrelic/apollo-server-plugin@1.0.0` | | `@apollo/server` | 4.0.0 | 4.11.3 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.738.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.738.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.738.0 | 8.7.1 | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.741.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.741.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.741.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@elastic/elasticsearch` | 7.16.0 | 8.17.0 | 11.9.0 | -| `@grpc/grpc-js` | 1.4.0 | 1.12.5 | 8.17.0 | +| `@grpc/grpc-js` | 1.4.0 | 1.12.6 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.3.12 | 9.0.0 | | `@koa/router` | 11.0.2 | 13.1.0 | 3.2.0 | | `@langchain/core` | 0.1.17 | 0.3.37 | 11.13.0 | | `@nestjs/cli` | 9.0.0 | 11.0.2 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.2.0 | 12.10.0 | -| `@prisma/client` | 5.0.0 | 6.3.0 | 11.0.0 | +| `@prisma/client` | 5.0.0 | 6.3.1 | 11.0.0 | | `@smithy/smithy-client` | 2.0.0 | 4.1.3 | 11.0.0 | | `amqplib` | 0.5.0 | 0,10,5 | 2.0.0 | | `apollo-server` | 3.0.0 | 3.13.0 | `@newrelic/apollo-server-plugin@1.0.0` | @@ -287,11 +287,11 @@ Após a instalação, o agente automaticamente instrumento com nosso catálogo d | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 11.0.2 | 13.0.1 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | -| `mongodb` | 4.1.4 | 6.12.0 | 1.32.0 | +| `mongodb` | 4.1.4 | 6.13.0 | 1.32.0 | | `mysql` | 2.2.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.12.0 | 1.32.0 | | `next` | 13.4.19 | 15.1.6 | 12.0.0 | -| `openai` | 4.0.0 | 4.81.0 | 11.13.0 | +| `openai` | 4.0.0 | 4.82.0 | 11.13.0 | | `pg` | 8.2.0 | 8.13.1 | 9.0.0 | | `pg-native` | 3.0.0 | 3.2.0 | 9.0.0 | | `pino` | 7.0.0 | 9.6.0 | 8.11.0 | diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx index e7df572db80..9973429b670 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/guide-using-ruby-agent-api.mdx @@ -273,7 +273,7 @@ O APM inclui diversas maneiras de registrar dados personalizados arbitrários. P - Crie um [evento personalizado](/docs/insights/insights-data-sources/custom-events). Consulte [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method). + Crie um [evento personalizado](/docs/insights/insights-data-sources/custom-events). Veja [`record_custom_event()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_custom_event-instance_method). @@ -293,7 +293,7 @@ O APM inclui diversas maneiras de registrar dados personalizados arbitrários. P - Crie uma [métrica personalizada](/docs/agents/manage-apm-agents/agent-data/custom-metrics). Consulte [`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method). + Crie uma [métrica personalizada](/docs/agents/manage-apm-agents/agent-data/custom-metrics). Veja [`record_metric()`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#record_metric-instance_method). @@ -479,4 +479,4 @@ Para obter instruções gerais sobre como usar as chamadas abaixo para implement - + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx index 61319dc796f..a2f96597961 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/sending-handled-errors-new-relic.mdx @@ -9,7 +9,7 @@ freshnessValidatedDate: never translationType: machine --- -Para enviar dados de erro que você está processando em seu próprio código para o New Relic, use a chamada da Ruby API do agente [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method) em seu gerenciador de erros. +Para enviar dados de erro que você está manipulando em seu próprio código para o New Relic, use a chamada da API do agente Ruby [`NewRelic::Agent.notice_error`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#notice_error-instance_method) no seu manipulador de erros. ## Notifique a New Relic Ruby [#solution] @@ -103,7 +103,7 @@ O `exception` é a exceção a ser registrada ou uma mensagem de erro. Se necess Suas ocorrências de erros estão mal agrupadas? Defina sua própria impressão digital de erro por meio de uma função de retorno de chamada. -Um retorno de chamada baseado em `Proc` pode ser fornecido ao agente para aplicar dinamicamente um [grupo de erros](/docs/errors-inbox/errors-inbox/#how-groups-work) desejado a cada erro detectado. Use a API do agente Ruby [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method) para fornecer um retorno de chamada ao agente. +Um retorno de chamada baseado em `Proc` pode ser fornecido ao agente para aplicar dinamicamente um [grupo de erros](/docs/errors-inbox/errors-inbox/#how-groups-work) desejado a cada erro observado. Use a API do agente Ruby [`NewRelic::Agent.set_error_group_callback`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_error_group_callback-instance_method) para fornecer ao agente um retorno de chamada. Esta chamada de API usa um método de retorno de chamada (deve ser do tipo `Proc`) como único argumento. O argumento é obrigatório. A chamada de API só precisa ser feita uma vez por lançamento do agente New Relic Ruby, portanto, a chamada pode ser feita em um inicializador Rails ou similar. Se forem feitas chamadas subsequentes à API, o método de retorno de chamada será atualizado para o método mais recente fornecido. Aqui está um exemplo de retorno de chamada sendo definido e passado para o método de API `NewRelic::Agent.set_error_group_callback` : @@ -212,7 +212,7 @@ Espera-se que o procedimento de retorno de chamada retorne uma string representa Agora você pode ver o número de usuários afetados por um grupo de erros. -Transações e erros podem ser associados a um ID de usuário se um for conhecido pelo agente New Relic Ruby. Use a API do agente Ruby [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method) para fornecer ao agente um ID de usuário. +Transações e erros podem ser associados a um ID de usuário, caso ele seja conhecido pelo agente Ruby do New Relic. Use a API do agente Ruby [`NewRelic::Agent.set_user_id`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#set_user_id-instance_method) para fornecer ao agente um ID de usuário. Esta chamada de API requer um único argumento de uma string que representa um identificador exclusivo para um usuário final. Essa string pode ser um UUID, um ID de banco de dados ou similar. A chamada da API deve ser feita pelo menos uma vez por transação para informar ao agente New Relic Ruby a qual ID de usuário associar a transação. Então, por sua vez, quando o agente perceber erros durante a vida útil da transação, os erros terão um atributo de agente `enduser.id` que contém o valor do ID do usuário. @@ -226,4 +226,4 @@ Defina uma das seguintes variáveis de ambiente para ajudar a identificar quais * `NEW_RELIC_METADATA_SERVICE_VERSION` adiciona o atributo `tags.service.version` aos dados do evento de erro contendo a versão do seu código que está implantada, geralmente uma versão semântica como `1.2.3`, mas nem sempre. * `NEW_RELIC_METADATA_RELEASE_TAG` adiciona o atributo `tags.releaseTag` aos dados do evento que contêm a tag de lançamento (como `v0.1.209` ou `release-209`). -* `NEW_RELIC_METADATA_COMMIT` adiciona o atributo `tags.commit` nos dados do evento que contém o commit sha. Você pode usar o sha inteiro ou apenas os primeiros sete caracteres (por exemplo, `734713b`). +* `NEW_RELIC_METADATA_COMMIT` adiciona o atributo `tags.commit` nos dados do evento que contém o commit sha. Você pode usar o sha inteiro ou apenas os primeiros sete caracteres (por exemplo, `734713b`). \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx index 2830b63734c..aed93d9d7d8 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/api-guides/third-party-instrumentation.mdx @@ -13,7 +13,7 @@ Este documento detalha como instrumentar gemas de terceiros com o agente Ruby , ## Encontrar extensões de terceiros -Qualquer um pode escrever uma joia baseada no agente Ruby. A New Relic mantém um repositório chamado [extends_newrelic_rpm](https://github.com/newrelic/extends_newrelic_rpm) para rastrear essas extensões e fornecer links para outras gems que constroem o agente Ruby. +Qualquer um pode escrever uma joia baseada no agente Ruby. A New Relic mantém um repositório chamado [extends\_newrelic\_rpm](https://github.com/newrelic/extends_newrelic_rpm) para rastrear essas extensões e fornecer links para outras gems que constroem o agente Ruby. Essas extensões **não** são suportadas pelo New Relic. A New Relic reúne esses links como um serviço aos nossos clientes. Problemas com essas joias devem ser relatados aos respectivos projetos no GitHub. @@ -26,10 +26,7 @@ A New Relic incentiva que extensões de terceiros sejam mantidas como gemas, com Se sua biblioteca fornece código que deve ser representado como uma transação completa no New Relic (por exemplo: uma solicitação da web ou trabalho em segundo plano que não é instrumentado pelo agente Ruby), use um desses mecanismos para iniciar uma transação. - + A maneira mais simples de iniciar uma transação é chamar `add_transaction_tracer` no método. Isso pressupõe que `NewRelic::Agent::Instrumentation::ControllerInstrumentation` esteja incluído em sua classe. ```ruby @@ -45,10 +42,7 @@ Se sua biblioteca fornece código que deve ser representado como uma transação ``` - + Às vezes você precisa de um pouco mais de controle sobre a transação gerada pelo New Relic. Quando isso acontecer, você poderá usar `perform_action_with_newrelic_trace`. Alguns dos parâmetros que você pode substituir incluem o nome e a categoria da transação (seja uma transação da web ou uma transação em segundo plano). ```ruby @@ -65,7 +59,7 @@ Se sua biblioteca fornece código que deve ser representado como uma transação end ``` - Consulte a [documentação completa de perform_action_with_newrelic_trace](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method) para obter mais informações sobre parâmetros e uso. + Veja a [documentação completa de perform\_action\_with\_newrelic\_trace](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Instrumentation/ControllerInstrumentation#perform_action_with_newrelic_trace-instance_method) para mais informações sobre parâmetro e uso. @@ -74,10 +68,7 @@ Se sua biblioteca fornece código que deve ser representado como uma transação Você pode querer adicionar informações de tempo ao New Relic sobre chamadas para um método, mas isso não representa uma transação completa. A New Relic recomenda adicionar um tracer de método para fazer isso. - + ```ruby require 'new_relic/agent/method_tracer' class Foo @@ -102,10 +93,7 @@ O agente Ruby fornece funcionalidade especial para gravar chamadas para datastor As métricas registradas através das funções do módulo `NewRelic::Agent::Datastores` aparecerão na [interface do banco de dados no New Relic](/docs/apm/applications-menu/monitoring/databases-slow-queries-dashboard). - + `trace` é a maneira mais simples de registrar o armazenamento de dados para um método. ```ruby @@ -125,10 +113,7 @@ As métricas registradas através das funções do módulo `NewRelic::Agent::Dat Observe que o armazenamento de dados métricos registrados com esta interface não permite adicionar um nome de coleção/tabela. Para isso, veja o método `wrap` abaixo. - + `wrap` permite registrar armazenamento de dados métricos com informações adicionais de coleção/tabela nos nomes das métricas. Ele também fornece um retorno de chamada para operações como a observação de instruções lentas. ```ruby @@ -162,10 +147,7 @@ As métricas registradas através das funções do módulo `NewRelic::Agent::Dat ``` - + Este método auxiliar registra consultas SQL lentas para apresentação no rastreamento da transação e páginas SQL lentas. O SQL é filtrado e ofuscado com base nas configurações do usuário. ```ruby @@ -179,10 +161,7 @@ As métricas registradas através das funções do módulo `NewRelic::Agent::Dat - + Este método auxiliar registra instruções para chamadas lentas do armazenamento de dados para rastrear a transação. Estes **não** são ofuscados. ```ruby @@ -202,10 +181,7 @@ As métricas registradas através das funções do módulo `NewRelic::Agent::Dat Você pode escrever testes automatizados ao criar uma gem que estende o New Relic. Os auxiliares de teste usados pelo próprio agente estão disponíveis para simplificar algumas tarefas comuns de teste. - + Os métodos de teste documentados nesta seção podem ser acessados chamando-o do seu código de teste (geralmente um arquivo `test_helper.rb` ) ```ruby @@ -213,10 +189,7 @@ Você pode escrever testes automatizados ao criar uma gem que estende o New Reli ``` - + Este método é a principal forma de garantir que suas métricas esperadas sejam registradas pelo agente Ruby. `refute_metrics_recorded` também está disponível. Na forma mais simples, `assert_metrics_recorded` pode ser chamado assim: @@ -234,10 +207,7 @@ Você pode escrever testes automatizados ao criar uma gem que estende o New Reli ``` - + Esses métodos simulam a execução na web ou transações em segundo plano. ```ruby @@ -247,10 +217,7 @@ Você pode escrever testes automatizados ao criar uma gem que estende o New Reli ``` - + A configuração do agente pode ser alterada para teste via `with_config`. É necessário aplicar um hash que é aplicado aos outros valores de configuração no agente. ```ruby @@ -264,10 +231,7 @@ Você pode escrever testes automatizados ao criar uma gem que estende o New Reli - + Se precisar testar sua extensão em várias versões de gem, você pode usar o Multiverse, uma parte do código de teste do próprio agente Ruby. Para obter exemplos de testes do Multiverse, consulte o [diretório suites nos arquivos do agente](https://github.com/newrelic/newrelic-ruby-agent/tree/master/test/multiverse/suites). Para configurar o Multiverse para sua própria gem: @@ -324,4 +288,4 @@ Você pode escrever testes automatizados ao criar uma gem que estende o New Reli * Após configurar o Multiverse para sua gem, execute `rake test:multiverse` para executar os testes em seu diretório. - + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx index 25c429cfda2..a26c194f100 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/background-jobs/monitor-ruby-background-processes.mdx @@ -11,7 +11,7 @@ translationType: machine Nosso agente Ruby utiliza automaticamente várias estruturas comuns de trabalho em segundo plano. Você também pode personalizá-lo para trace quaisquer tarefas em segundo plano. Os dados de tarefas em segundo plano aparecem na [página**Transactions** ](/docs/apm/applications-menu/monitoring/transactions-page)do APM como **Non-web transactions**. -## Estrutura suportada [#supported_frameworks] +## Estrutura suportada [#supported\_frameworks][#supported_frameworks] A seguinte estrutura de trabalho em segundo plano é suportada por padrão em versões recentes do agente Ruby: @@ -25,7 +25,7 @@ A seguinte estrutura de trabalho em segundo plano é suportada por padrão em ve Se você estiver usando essa estrutura, o monitoramento de trabalhos em segundo plano normalmente não requer configuração adicional. -## Monitor trabalhos personalizados em segundo plano [#custom_background_jobs] +## Monitor trabalhos personalizados em segundo plano [#custom\_background\_jobs][#custom_background_jobs] Você pode instrumentar trabalhos em segundo plano personalizados para que apareçam na [página**Transactions** ](/docs/apm/applications-menu/monitoring/transactions-page)do APM como **Non-web transactions**. Para monitor **Non-web transactions** enquanto estiver usando um framework não suportado, você deve adicionar instrumentação personalizada. @@ -52,7 +52,7 @@ Por exemplo, um trabalho em segundo plano executa periodicamente uma tarefa cham Você pode passar uma string para `:category`, mas os valores só aparecerão na página **Transactions** do APM se a string começar com `OtherTransaction/`. -## Monitor métodos de plano de fundo personalizados [#custom_methods] +## Monitor métodos de plano de fundo personalizados [#custom\_methods][#custom_methods] Usando a API do agente Ruby, você pode designar métodos específicos para trace o **Non-web transactions**. Isso reúne rastreamento de trabalhos de execução lenta e associa erros capturados à transação. @@ -104,31 +104,25 @@ NewRelic::Agent.manual_start(:sync_startup => true) Usar `require 'new_relic/agent'` exigirá o código do agente e garantirá que o agente não seja executado até que você o inicie manualmente. -Se o processo for mais curto que o [ciclo de coleta](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle) do agente , será necessário encerrar manualmente o agente com [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown) para garantir que todos os dados na fila sejam enviados. +Se o processo for mais curto que o [ciclo de coleta](/docs/using-new-relic/welcome-new-relic/get-started/glossary#harvest-cycle) do agente, você precisará desligar manualmente o agente com [`::NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:shutdown) para garantir que todos os dados enfileirados sejam enviados. -## Configure newrelic.yml para processos em segundo plano [#config_file] +## Configure newrelic.yml para processos em segundo plano [#config\_file][#config_file] A configuração do **newrelic.yml** depende do contexto do aplicativo em segundo plano. - - Se seu aplicativo em segundo plano não for Rails e já estiver executando o agente Ruby, copie seu arquivo **newrelic.yml** para o diretório onde você lançou o trabalho em segundo plano ou no subdiretório **config** . Certifique-se de que inclui seu . + + Se seu aplicativo em segundo plano não for Rails e já estiver executando o agente Ruby, copie seu arquivo **newrelic.yml** para o diretório onde você lançou o trabalho em segundo plano ou no subdiretório **config** . Certifique-se de que inclui seu . Tarefas em segundo plano que não são executadas em um contexto Rails examinarão a variável de ambiente `NEW_RELIC_ENV` para determinar qual seção do arquivo de configuração ler, recorrendo às variáveis de ambiente `RUBY_ENV`, `RAILS_ENV` e `RACK_ENV` em sequência, e finalmente padronizando `development` se nenhuma dessas variáveis de ambiente estiver definida. - + Se sua tarefa em segundo plano for executada no contexto de um aplicativo Web existente que já está sendo monitorado com o New Relic, o agente Ruby selecionará automaticamente seu arquivo **newrelic.yml** existente. Os trabalhos em segundo plano que inicializam o ambiente Rails do seu aplicativo usarão a variável de ambiente `RAILS_ENV` para determinar qual seção do arquivo **newrelic.yml** ler. -## Reportar para um nome de aplicativo alternativo [#reporting_to_an_alternate_application_name] +## Reportar para um nome de aplicativo alternativo [#reporting\_to\_an\_alternate\_application\_name][#reporting_to_an_alternate_application_name] Você pode fazer com que trabalhos executados no contexto de um aplicativo da web existente do New Relic apareçam com um [nome de aplicativo diferente](/docs/apm/new-relic-apm/installation-configuration/naming-your-application) na interface do APM. @@ -141,22 +135,16 @@ Você pode fazer com que trabalhos executados no contexto de um aplicativo da we ./bin/my_background_worker.rb ``` -## Certifique-se de que o agente seja iniciado [#start_agent] +## Certifique-se de que o agente seja iniciado [#start\_agent][#start_agent] O agente Ruby será iniciado automaticamente na maioria dos casos assim que você `require 'newrelic_rpm'`, a menos que o agente detecte um nome executável na lista negra, um nome de tarefa rake ou uma constante. Isso evita que ele seja iniciado durante tarefas comuns de rake e sessões de console interativas. - + O script independente executado sem Rails geralmente iniciará o agente assim que `require 'newrelic_rpm'`. Se você tiver um script que bifurca ou daemoniza antes de iniciar seu trabalho principal, você pode querer adiar essa chamada `require` até depois que a configuração inicial for concluída. - + Se você usar o [daemon gem](https://rubygems.org/gems/daemons) para iniciar tarefas em segundo plano, o agente Ruby poderá falhar ao iniciar e também não emitir nenhum registro. Isso acontece porque a gem do daemon altera o diretório de trabalho para `/` antes de executar seu código em segundo plano. O agente então tenta resolver os caminhos para seu arquivo de configuração e arquivo de log relativo ao diretório de trabalho atual do processo host. Para permitir que o agente seja iniciado nesta situação, configure variáveis de ambiente com os locais do arquivo de configuração e do arquivo de log do agente; por exemplo: @@ -172,7 +160,7 @@ O agente Ruby será iniciado automaticamente na maioria dos casos assim que voc Para obter mais informações, consulte a documentação sobre como [controlar a inicialização do agente](/docs/agents/ruby-agent/troubleshooting/controlling-when-ruby-agent-starts) -## Monitor script [#monitoring_scripts] +## Monitor script [#monitoring\_scripts][#monitoring_scripts] As [instruções de inicialização do agente](#start_agent) se aplicam à execução de tarefas em segundo plano em um daemon. Se um script executar uma única tarefa em segundo plano e sair, encerre manualmente o agente com `::NewRelic::Agent.shutdown` quando o script for concluído. Isso garante que o coletor New Relic receba os dados. Por exemplo: @@ -190,4 +178,4 @@ end SalesOrganization.new.find_new_leads ::NewRelic::Agent.shutdown -``` +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx index e6a957c4b64..eb6f821ba42 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-7x-guide.mdx @@ -151,4 +151,4 @@ As solicitações pull relevantes são: **Potential issue:** Erros são gerados no código do aplicativo ao chamar os métodos da API `create_distributed_trace_payload` e `accept_distributed_trace_payload`. -**Solution:** Em vez disso, consulte [`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method) e [`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method), respectivamente. +**Solution:** Em vez disso, veja [`insert_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#insert_distributed_trace_headers-instance_method) e [`accept_distributed_trace_headers`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/DistributedTracing#accept_distributed_trace_headers-instance_method), respectivamente. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx index 8edccb24f4e..ec86d73b1f0 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/migration-8x-guide.mdx @@ -21,7 +21,7 @@ As principais mudanças incluem: Consulte o [marco da versão 8.0](https://github.com/newrelic/newrelic-ruby-agent/milestone/10?closed=1) para obter mais informações. -## Mudanças no método da API `add_method_tracer` [#add_method_tracer] +## Mudanças no `add_method_tracer` [#add\_method\_tracer][#add_method_tracer] ### O parâmetro de nome da métrica aceita Procs; strings não são mais interpoladas @@ -81,7 +81,7 @@ Observe que o primeiro nome da métrica será criado como uma métrica com escop Vimos apenas um erro surgir em um ambiente de teste chamando métodos Mocha. No entanto, recomendamos que você verifique a funcionalidade do seu aplicativo quando houver resolução de problemas. -## Distributed tracing está ativado por padrão [#distributed_tracing] +## Distributed tracing está ativado por padrão [#distributed\_tracing][#distributed_tracing] A opção de configuração padrão para `distributed_tracing.enabled` é definida como verdadeira para versões 8.0 ou superiores. Para desativar distributed tracing, defina esta opção de configuração como falsa em seu `newrelic.yml`. @@ -90,7 +90,7 @@ distributed_tracing: enabled: false ``` -## O rastreamento multiaplicativo está obsoleto [#cross_application_tracing] +## O rastreamento multiaplicativo está obsoleto [#cross\_application\_tracing][#cross_application_tracing] [multiaplicativo Tracing](/docs/agents/ruby-agent/features/cross-application-tracing-ruby/) está obsoleto na versão 8.0 e será removido em uma versão futura. @@ -108,7 +108,7 @@ distributed_tracing: ``` -## Métodos de API obsoletos e instrumentação herdada foram removidos [#removed_deprecated] +## Métodos de API obsoletos e instrumentação herdada foram removidos [#removed\_deprecated][#removed_deprecated] Os métodos a seguir foram obsoletos anteriormente e agora foram removidos. @@ -132,7 +132,7 @@ Os métodos a seguir foram obsoletos anteriormente e agora foram removidos. - [`disable_all_tracing`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:disable_all_tracing) ou [`ignore_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:ignore_transaction) Métodos de API + Métodos de API [`disable_all_tracing`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:disable_all_tracing) ou [`ignore_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent:ignore_transaction) @@ -142,7 +142,7 @@ Os métodos a seguir foram obsoletos anteriormente e agora foram removidos. - [`Tracer#start_external_request_segment`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.start_external_request_segment) Método de API + [`Tracer#start_external_request_segment`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.start_external_request_segment) Método API @@ -152,7 +152,7 @@ Os métodos a seguir foram obsoletos anteriormente e agora foram removidos. - [`Tracer#in_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.in_transaction) Método de API + [`Tracer#in_transaction`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent/Tracer.in_transaction) Método API @@ -176,4 +176,4 @@ Os métodos a seguir foram obsoletos anteriormente e agora foram removidos. - + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx index 4d792885ec6..131e3ef7155 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/troubleshooting/control-when-ruby-agent-starts.mdx @@ -140,12 +140,12 @@ O agente Ruby inicia em contextos onde não quero que seja iniciado. - A API [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) pode ser usada para iniciar o agente em contextos específicos. Se você definir `:agent_enabled` como `false` em seu arquivo de configuração ou definir a variável de ambiente `NEW_RELIC_AGENT_ENABLED=false`, ainda poderá iniciar manualmente o agente usando esta API. + A API [`NewRelic::Agent.manual_start`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#manual_start-instance_method) pode ser usada para iniciar o agente em contextos específicos. Se você definir `:agent_enabled` como `false` no seu arquivo de configuração ou definir a variável de ambiente `NEW_RELIC_AGENT_ENABLED=false`, ainda poderá iniciar manualmente o agente usando esta API. ```ruby NewRelic::Agent.manual_start(agent_enabled: true) ``` - Se quiser interromper o agente antes do término do processo, você pode ligar para [`NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#shutdown-instance_method). + Se você quiser parar o agente antes que o processo termine, você pode chamar [`NewRelic::Agent.shutdown`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#shutdown-instance_method). - + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx b/src/i18n/content/pt/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx index 931b98cf485..4149b62c683 100644 --- a/src/i18n/content/pt/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx +++ b/src/i18n/content/pt/docs/data-apis/custom-data/custom-events/collect-custom-attributes.mdx @@ -221,7 +221,7 @@ Para ativar e usar o atributo personalizado para APM, siga o procedimento para s - A coleção atributo personalizado está habilitada por padrão em Ruby. Para coletar um atributo personalizado, chame o método [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method) . Por exemplo, para registrar uma variável chamada `@user_id`, inclua este código no método pai: + A coleção de atributos personalizados é habilitada por padrão no Ruby. Para coletar um atributo personalizado, chame o método [`add_custom_attributes`](https://www.rubydoc.info/gems/newrelic_rpm/NewRelic/Agent#add_custom_attributes-instance_method) . Por exemplo, para registrar uma variável chamada `@user_id`, inclua este código no método pai: ```ruby ::NewRelic::Agent.add_custom_attributes({ user_id: @user.id }) @@ -247,4 +247,4 @@ Agente mobile inclui chamada de API para registrar atributo personalizado: ## Monitor Sintético: Record atributo personalizado [#synthetics] -Veja [Sintético monitor atributo personalizado](/docs/synthetics/synthetic-monitoring/scripting-monitors/add-custom-attributes-synthetic-monitoring-data). +Veja [Sintético monitor atributo personalizado](/docs/synthetics/synthetic-monitoring/scripting-monitors/add-custom-attributes-synthetic-monitoring-data). \ No newline at end of file diff --git a/src/i18n/content/pt/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx b/src/i18n/content/pt/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx index 88c81e3e409..485300d1c48 100644 --- a/src/i18n/content/pt/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx +++ b/src/i18n/content/pt/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator.mdx @@ -96,18 +96,18 @@ kubectl apply -f ./values.yaml -n newrelic ### Como usar seletores [#selectors] -Para saber quando a instrumentação CR vai injetar o agente APM, precisamos usar seletores. Há 2 seletores de rótulos disponíveis que você pode usar juntos (eles funcionam como um operador lógico AND (&&)) ou separadamente, dependendo de suas necessidades. +Para saber quando a instrumentação CR vai injetar o agente APM, precisamos usar seletores. Há 2 seletores de rótulos disponíveis que você pode usar juntos (eles agem como um operador lógico AND (`&&`)) ou separadamente, dependendo de suas necessidades. * `PodLabelSelector` informa ao APM Auto-attach qual pod precisa ser instrumentado. Exemplo usando `matchLabel` (pod select contendo uma tag e valor específicos): ```yaml - ... - podLabelSelector: - matchLabels: - app.kubernetes.io/name: flask-hello-world - ... + ... + podLabelSelector: + matchLabels: + app.kubernetes.io/name: flask-hello-world + ... ``` * `NameSpaceLabelSelector` define no nível do namespace o pod auto-instrumentado. @@ -115,13 +115,13 @@ Para saber quando a instrumentação CR vai injetar o agente APM, precisamos usa Exemplo usando `matchExpressions` (selecione namespace contendo uma tag e valor específicos): ```yaml - ... - namespaceLabelSelector: - matchExpressions: - - key: "kubernetes.io/metadata.name" - operator: "In" - values: ["backend"] - ... + ... + namespaceLabelSelector: + matchExpressions: + - key: "kubernetes.io/metadata.name" + operator: "In" + values: ["backend"] + ... ``` @@ -143,14 +143,14 @@ Ambos os seletores suportam `matchLabel` e `matchExpressions`. `matchExpressions` é um seletor de rótulos mais expressivo no Kubernetes e oferece suporte à correspondência baseada em conjuntos, diferentemente do `matchLabels`, que você só pode usar para correspondência exata. Você pode usá-lo com ou sem o seletor `matchLabels` . ```yaml - ... - selector: - matchLabels: - tier: frontend - matchExpressions: - - {key: name, operator: In, values: [payroll, web]} - - {key: environment, operator: NotIn, values: [dev]} - ... + ... + selector: + matchLabels: + tier: frontend + matchExpressions: + - {key: name, operator: In, values: [payroll, web]} + - {key: environment, operator: NotIn, values: [dev]} + ... ``` Você pode adicionar mais expressões ao seletor. Como no exemplo, cada expressão deve conter uma chave, um operador e possivelmente (dependendo do operador) uma lista de valores. Existem quatro operadores válidos: @@ -275,12 +275,12 @@ Você precisa especificar o agente APM e sua versão no CR de instrumentação. Veja este exemplo: ```yaml - ... - spec: - agent: - language: dotnet - image: newrelic/newrelic-dotnet-init:latest - ... +... +spec: + agent: + language: dotnet + image: newrelic/newrelic-dotnet-init:latest +... ``` ### Parâmetro de configuração APM [#apm-config-parameters] @@ -288,15 +288,15 @@ Veja este exemplo: A instrumentação CR fornece a capacidade de injetar variáveis de ambiente no pod para agilizar a configuração do agente APM. Veja este exemplo: ```yaml - ... - spec: - env: - # Example overriding the appName configuration by using a label of the pod - - name: NEW_RELIC_APP_NAME - valueFrom: - fieldRef: - fieldPath: metadata.labels['app.kubernetes.io/name'] - ... +... +spec: + env: + # Example overriding the appName configuration by using a label of the pod + - name: NEW_RELIC_APP_NAME + valueFrom: + fieldRef: + fieldPath: metadata.labels['app.kubernetes.io/name'] +... ``` No exemplo acima, mostramos como você pode configurar as configurações do agente globalmente usando variáveis de ambiente. Consulte a documentação de configuração de cada agente para obter as opções de configuração disponíveis: @@ -320,8 +320,8 @@ Ao instalá-lo, um é criado e é a licença ```bash kubectl create secret generic newrelic-key-secret \ - --namespace my-monitored-namespace \ - --from-literal=new_relic_license_key= + --namespace my-monitored-namespace \ + --from-literal=new_relic_license_key=YOUR_NEW_RELIC_INGEST_LICENSE_KEY ``` * Para referenciar o segredo do CR de instrumentação, execute este comando: @@ -459,9 +459,9 @@ O anexo automático do Kubernetes APM pode oferecer suporte a [`cert-manager`](h ```shell helm install cert-manager jetstack/cert-manager \ - --namespace cert-manager \ - --create-namespace \ - --set crds.enabled=true + --namespace cert-manager \ + --create-namespace \ + --set crds.enabled=true ``` * No seu arquivo `values.yaml` , defina `admissionWebhooks.autoGenerateCert.enabled: false` e `admissionWebhooks.certManager.enabled: true`. Depois, instale o gráfico normalmente. @@ -532,7 +532,7 @@ Caso seu aplicativo não esteja instrumentado, você deverá verificar o seguint * Verifique se o pod possui os rótulos necessários que permitem a instrumentação automática por meio do CR ao usar `podLabelSelector`. Da mesma forma, verifique se o namespace tem os rótulos necessários ao usar `namespaceLabelSelector` dentro do CR. ```bash - kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' + kubectl get pod POD_NAME -n NAMESPACE -o jsonpath='{.metadata.annotations}' ``` * Execute este comando para obter o log do de APM conexão automática pod: diff --git a/src/i18n/content/pt/docs/logs/forward-logs/azure-log-forwarding.mdx b/src/i18n/content/pt/docs/logs/forward-logs/azure-log-forwarding.mdx index e7590929e09..b92488a0934 100644 --- a/src/i18n/content/pt/docs/logs/forward-logs/azure-log-forwarding.mdx +++ b/src/i18n/content/pt/docs/logs/forward-logs/azure-log-forwarding.mdx @@ -16,7 +16,7 @@ translationType: machine Se o seu log já estiver sendo coletado no Azure, você poderá usar nossos modelos [Microsoft Azure Resource Manager (ARM)](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/overview) para encaminhá-los e enriquecê-los no New Relic. -Encaminhar seu registro do Azure para New Relic proporcionará recursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus dados log . +Encaminhar seu registro do Azure para New Relic proporcionará recursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus dados log . Atualmente, oferecemos dois modelos ARM para conseguir isso: os modelos baseados em EventHub (recomendado) e os modelos baseados em Blob Storage. @@ -35,8 +35,8 @@ Para enviar o log do seu hub de eventos: Siga esses passos: -1. Certifique-se de ter um . -2. Em **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**, clique em **Integrations & Agents** na navegação esquerda. +1. Certifique-se de ter um . +2. Em **[one.newrelic.com](https://one.newrelic.com/launcher/logger.log-launcher)**, clique em **Integrations & Agents** na navegação esquerda. 3. Na categoria **Logging** , clique no bloco **Microsoft Azure Event Hub** na lista de fontes de dados. 4. Selecione a conta para a qual deseja enviar o registro e clique em **Continue**. 5. Clique em **Generate API key** e copie a chave de API gerada. @@ -49,7 +49,7 @@ Siga esses passos: Observe que o modelo é idempotente. Você pode iniciar o encaminhamento do log do Event Hub e, em seguida, executar novamente o mesmo modelo para configurar o encaminhamento [do log de atividades do Azure assinatura](#subscription-activity-logs) , concluindo a etapa 10. - + ### Opcional: envie o log de atividades do Azure da sua assinatura [#subscription-activity-logs] @@ -88,17 +88,11 @@ No exemplo a seguir, demonstraremos como encaminhar o log de atividades de um re 2. Navegue até seu serviço Kubernetes: - Kubernetes Service Button + Kubernetes Service Button 3. No menu à esquerda, selecione **Monitoring`>`Diagnostic Settings**: - Diagnostic Settings menu + Diagnostic Settings menu 4. Clique em **Add diagnostic setting**. @@ -108,10 +102,7 @@ No exemplo a seguir, demonstraremos como encaminhar o log de atividades de um re 7. Em **Destination details**, selecione **Stream to an event hub** e configure `Event hub namespace`, `Event hub name` e `Event hub policy name`. Caso você tenha optado por criar um novo evento Hub e um namespace durante a [implantação do modelo ARM](#eventhub-arm-setup), selecione as seguintes configurações criadas automaticamente (o nome do namespace terá um sufixo diferente): - Destination details settings + Destination details settings 8. Clique em **Save** para começar a encaminhar seu log Kubernetes para o New Relic: @@ -134,8 +125,8 @@ Para enviar os blobs de um contêiner na sua conta de armazenamento, siga estas Siga esses passos: -1. Certifique-se de ter um . -2. Vá para **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** e, à esquerda, clique em **Integrations & Agents**. +1. Certifique-se de ter um . +2. Vá para **[the logs UI](https://one.newrelic.com/launcher/logger.log-launcher)** e, à esquerda, clique em **Integrations & Agents**. 3. Em **Logging**, clique no bloco `Microsoft Azure Blob Storage` . 4. Selecione a conta para a qual deseja enviar o registro e clique em **Continue**. 5. Clique em **Generate API key** e copie o **API key** gerado. @@ -160,7 +151,7 @@ SELECT * FROM Log Se você quiser consultar apenas o log vindo do Azure, execute a seguinte consulta: ```sql -SELECT * FROM Log where plugin.type='azure' +SELECT * FROM Log WHERE plugin.type = 'azure' ``` ## Resolução de problemas [#troubleshoot] @@ -168,19 +159,11 @@ SELECT * FROM Log where plugin.type='azure' Se você encontrar problemas ao configurar seu direcionador de logs, tente estas dicas de resolução de problemas: - + Se nenhum dado aparecer após você ativar nossos recursos de gerenciamento de logs, siga nossos [procedimentos padrão de resolução de problemas de log](/docs/logs/log-management/troubleshooting/no-log-data-appears-ui/). - + A invocação do Azure Functions para encaminhar nosso log falha em arquivos acima de um determinado tamanho (aproximadamente 105 MB). Isso se deve a um erro de falta de memória causado pelo fato de a associação Node.js do Azure Functions [não suportar streaming](https://github.com/Azure/azure-functions-host/issues/1361). Este é um problema conhecido e não pode ser mitigado, exceto reduzindo o tamanho do log que você carrega. @@ -200,16 +183,17 @@ Se você implantar nossos modelos ARM antes de maio de 2023, modifique sua confi Se você tiver alguma dúvida sobre este aviso, entre em contato com [nossa equipe de suporte](https://support.newrelic.com). - + Modificar esta configuração é bastante complexo, pois envolve: * Criando outra conta de armazenamento de acesso privado. + * Movendo todos os compartilhamentos de arquivos e blobs para esta nova conta de armazenamento de acesso privado. + * Criação de ponto final privado para a nova conta de armazenamento de acesso privado. + * Criando registros DNS para o novo ponto final privado. + * Modificando a configuração de rede do aplicativo de funções adequadamente. Devido a esta complexidade, recomendamos que você reimplante nosso modelo ARM do zero em vez de tentar modificar manualmente esta configuração. @@ -219,82 +203,54 @@ Se você tiver alguma dúvida sobre este aviso, entre em contato com [nossa equi - + 1. Acesse a conta de armazenamento criada pelo modelo ARM. - 2. No menu esquerdo, vá para **Settings > Configuration**. + 2. No menu esquerdo, vá para **Settings > Configuration**. 3. Em **Allow Blob public access**, selecione **Disabled**. - Disabling public access to the blobs/containers in the Storage account + Disabling public access to the blobs/containers in the Storage account 4. Clique em **Save**. - + 1. Acesse o Aplicativo de Funções que foi criado pelo modelo ARM. - 2. No menu esquerdo, vá para **Settings > Configuration**. + 2. No menu esquerdo, vá para **Settings > Configuration**. 3. Selecione a guia **General settings** . 4. Em **Platform settings**, para **FTP state**, selecione **Disabled**. - Disabling FTP access to the Function App + Disabling FTP access to the Function App 5. Clique em **Save**. - + 1. Acesse o Aplicativo de Funções que foi criado pelo modelo ARM. - 2. No menu esquerdo, vá para **Settings > Configuration**. + 2. No menu esquerdo, vá para **Settings > Configuration**. 3. Selecione a guia **General settings** . 4. Em **Platform settings**, para **HTTPS Only**, selecione **On**. - Enforcing HTTPS to the Function App + Enforcing HTTPS to the Function App 5. Clique em **Save**. - + 1. Acesse o Aplicativo de Funções que foi criado pelo modelo ARM. - 2. No menu esquerdo, vá para **Settings > Networking**. + 2. No menu esquerdo, vá para **Settings > Networking**. 3. Dentro da caixa **Inbound Traffic** , clique em **Access restriction**. - Disabling public network access to the Function App + Disabling public network access to the Function App 4. Em **App access**, desmarque a caixa de seleção **Allow public access** . @@ -312,4 +268,4 @@ Explore os dados de registro em sua plataforma com nossa [interface de registros ## Desativar encaminhamento de logs [#disable] -Para desabilitar os recursos de encaminhamento de logs, siga os procedimentos padrão na [documentação do log de atividadesMicrosoft Azure ](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log). Você não precisa fazer mais nada no New Relic. +Para desabilitar os recursos de encaminhamento de logs, siga os procedimentos padrão na [documentação do log de atividadesMicrosoft Azure ](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/activity-log). Você não precisa fazer mais nada no New Relic. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx b/src/i18n/content/pt/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx index adacd25c16e..06a135f8730 100644 --- a/src/i18n/content/pt/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx +++ b/src/i18n/content/pt/docs/opentelemetry/best-practices/opentelemetry-best-practices-resources.mdx @@ -104,6 +104,39 @@ New Relic suporta relacionamentos entre entidades provenientes da instrumentaç Os relacionamentos entre um serviço e uma entidade de host exigem que o serviço inclua o atributo de recurso `host.id` e que corresponda ao `host.id` do host em que está sendo executado. +### Amazon CloudWatch Metric Streams + +Sua infraestrutura hospedada na AWS pode ser monitorada com a integração do New Relic com [o Amazon CloudWatch Metric Streams](/install/aws-cloudwatch/). Esta não é uma solução OpenTelemetry para monitorar sua infraestrutura. No entanto, o New Relic oferece suporte a uma série de relacionamentos entre serviços instrumentados OpenTelemetry e infraestrutura monitorada usando Amazon CloudWatch Metric Streams. + + + Os relacionamentos descritos abaixo aproveitam as convenções semânticas do OpenTelemetry. Muitas dessas convenções ainda não são estáveis e ainda estão evoluindo. instrumentação que produz telemetria para o framework abaixo variam em seu nível de maturidade e conformidade com as convenções semânticas. Dessa forma, a instrumentação que você usa pode não emitir o atributo necessário para que esses relacionamentos funcionem. Entre em contato com os mantenedores da instrumentação que você está usando caso tenha alguma dúvida sobre a maturidade da instrumentação em relação às convenções semânticas do OpenTelemetry. + + +#### ElastiCache (Memcached) + +A integração do Amazon CloudWatch Metric Streams para [Elasticache](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-elasticache-monitoring-integration/) gera entidade do ElastiCache no New Relic. Estas entidades terão a seguinte etiqueta entidade: + +* `aws.elasticache.configurationEndpointAddress` ou `aws.elasticache.endpointAddress` +* `aws.elasticache.configurationEndpointPort` ou `aws.elasticache.endpointPort` + +Se seus serviços utilizam instrumentação OpenTelemetry para Memcached ele deve emitir o seguinte atributo para que um relacionamento seja gerado: + +* `db.system`: Este atributo deve ter o valor `memcached`. +* `net.peer.name`: Este atributo deve corresponder à correspondente endpoint tag da entidade ElastiCache. +* `net.peer.port`: Este atributo deve corresponder à tag de porta correspondente da entidade ElastiCache. + +#### Amazon MQ (ActiveMQ) + +A integração do Amazon CloudWatch Metric Streams para [Amazon MQ](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-mq-integration) gera entidade do Amazon MQ no New Relic. Estas entidades terão a seguinte tag entidade: + +* `aws.mq.endpoint` + +Se seus serviços utilizam instrumentação OpenTelemetry para ActiveMQ é necessário o seguinte atributo para que um relacionamento seja gerado: + +* `messaging.system`: Este atributo deve ter o valor `activemq`. +* `server.address`: Este atributo deve corresponder à tag de endpoint correspondente da entidade do Amazon MQ. +* `span.kind`: Este relacionamento é gerado a partir de dados de intervalo onde `span.kind` é `producer` ou `consumer`. + ## Adicionando tag personalizada a uma entidade [#tags] Você pode usar tag para organizar e filtrar sua entidade na interface. [tag](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/) são pares de valores principais, por exemplo `team: operations`, adicionados a vários conjuntos de dados, como aplicativos de monitoramento e hosts. Certos atributos importantes ficam automaticamente disponíveis como tag, como ID da conta; você também pode adicionar sua própria tag personalizada [diretamente na interface](/docs/new-relic-solutions/new-relic-one/core-concepts/use-tags-help-organize-find-your-data/#add-tags) ou com um dos métodos abaixo.