Skip to content

Commit

Permalink
Merge pull request #19362 from newrelic/translations-ed49e757
Browse files Browse the repository at this point in the history 
Updated translations -  (machine translation)
  • Loading branch information
@jmiraNR
jmiraNR authored Nov 22, 2024
2 parents 64e453d + ed49e75 commit f5aba75
Show file tree
Hide file tree
Showing 26 changed files with 1,534 additions and 951 deletions.
12 changes: 12 additions & 0 deletions .../content/es/docs/apm/agents/net-agent/configuration/net-agent-configuration.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3279,6 +3279,7 @@ Hay tres subcaracterísticas principales:

* Datos de contexto (a través de [`AddCustomAttribute`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#addcustomattribute)): cuando esté habilitado, el agente capturará y reenviará cualquier atributo log personalizado. Los elementos `include` y `exclude` son listas separadas por comas de nombres de atributos para incluir o excluir, siguiendo las [mismas reglas](/docs/apm/agents/net-agent/attributes/enable-disable-attributes-net/#attruls) que la configuración de otros atributos de agente. Ambos están vacíos de forma predeterminada, lo que da como resultado que todos los datos del contexto log se capturen y reenvíen.
* Filtrado de niveles de logs: cuando se configura con uno o más niveles de logs en una lista separada por comas, el agente evitará que los mensajes en esos niveles sean capturados y reenviados.
* Etiquetas: cuando está habilitado, el agente agrega etiquetas personalizadas al registro reenviado por el agente. Puede emplear el atributo `exclude` , que es una lista de nombres de etiquetas separados por comas y que no distingue entre mayúsculas y minúsculas. De forma predeterminada, el agente agrega etiquetas personalizadas cuando el atributo `exclude` está vacío.

3. Decoración log local: cuando esté habilitado, su registro existente se decorará con metadatos que vinculan el registro con otros datos de New Relic, como los errores.

Expand All @@ -3289,6 +3290,7 @@ Para obtener más detalles, consulte [nuestros documentos sobre el uso de logs e
<metrics enabled="true" />
<forwarding enabled="true" maxSamplesStored="10000" logLevelDenyList="">
<contextData enabled="false" include="" exclude="" />
<labels enabled="false" exclude="" />
</forwarding>
<localDecorating enabled="false" />
</applicationLogging>
Expand All @@ -3305,6 +3307,8 @@ NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE="myCustomAttribute
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE="myCustomAttribute2, myOtherCustomAttributeMoreSpecificName"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST="debug, warn"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE="label1, label2"
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true
```

Expand Down Expand Up @@ -3375,6 +3379,14 @@ El elemento `applicationLogging` admite los siguientes atributos y subelementos:
Las listas de inclusión y exclusión siguen las [mismas reglas de precedencia que la configuración de otros atributos del agente](/docs/apm/agents/net-agent/attributes/enable-disable-attributes-net/#attruls).
</Collapser>

<Collapser id="labels" title="etiquetas (etiqueta)">
Emplee este subelemento, que es un elemento secundario del elemento `forwarding` , para configurar la adición de sus [etiquetas (etiqueta)](/docs/apm/agents/net-agent/configuration/net-agent-configuration/#labels-tags) al registro reenviado por agente, en las versiones de agente 10.34.0 y superiores.

Establezca el atributo `enabled` en `true` para permitir agregar sus etiquetas al registro reenviado por el agente. También puede emplear la variable de entorno `NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED`. El valor predeterminado es `false`.

El atributo `exclude` es una lista de nombres de etiquetas separados por comas y que no distingue entre mayúsculas y minúsculas, que se deben excluir cuando se habilitan las etiquetas. También puede emplear la variable de entorno `NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE`. El valor predeterminado es una cadena vacía, lo que significa &amp;quot;no excluir nada&amp;quot;. Este atributo no admite comodines ni expresiones regulares.
</Collapser>

<Collapser id="localDecorating" title="Decoración log locales">
Utilice este subelemento para habilitar la decoración del registro de su aplicación con metadatos de enlace de New Relic. El valor predeterminado del atributo `enabled` es `false`. Se requieren algunos cambios de configuración adicionales para la decoración log local; consulte [.NET: Configurar logs en el contexto](/docs/logs/logs-context/net-configure-logs-context-all#2-decorate) para obtener más información.
</Collapser>
Expand Down
69 changes: 66 additions & 3 deletions src/i18n/content/es/docs/apm/agents/net-agent/net-agent-api/net-agent-api.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2160,7 +2160,7 @@ La siguiente lista contiene las diferentes llamadas que puede realizar con la AP

### Descripción

Establece el nombre de la transacción actual. Antes de utilizar esta llamada, asegúrese de comprender las implicaciones de los [problemas de agrupación métrica](/docs/agents/manage-apm-agents/troubleshooting/metric-grouping-issues).
Establezca un nombre de transacción personalizado, que se agregará luego de un prefijo inicial (`WebTransaction` o `OtherTransaction`) según el tipo de transacción actual. Antes de emplear esta llamada, cerciorar de comprender las participaciones de [los problemas de agrupación métrica](/docs/agents/manage-apm-agents/troubleshooting/metric-grouping-issues).

Si utiliza esta llamada varias veces dentro de la misma transacción, cada llamada sobrescribe la llamada anterior y la última llamada establece el nombre.

Expand Down Expand Up @@ -2218,8 +2218,71 @@ La siguiente lista contiene las diferentes llamadas que puede realizar con la AP

### Ejemplos

Este ejemplo muestra el uso de esta API en un controlador ASP..NET Core MVC. Una transacción es creada automáticamente por la instrumentación del agente para ASP..NET Core. La primera parte del nombre de la transacción seguirá siendo `WebTransaction`.

```cs
public class HomeController : Controller
{

public IActionResult Order(string product)
{

// The commented-out API call below is probably a bad idea and will lead to a metric grouping issue (MGI)
// because too many transaction names will be created. Don't do this.
//NewRelic.Api.Agent.NewRelic.SetTransactionName("Other", $"ProductOrder-{product}");
// Do this instead if you want to record request-specific data about this MVC endpoint
var tx = NewRelic.Api.Agent.NewRelic.GetAgent().CurrentTransaction;
tx.AddCustomAttribute("productName", product);

// The default transaction name at this point will be: WebTransaction/MVC/Home/Order
// Set custom transaction name
NewRelic.Api.Agent.NewRelic.SetTransactionName("Other", "OrderProduct");

// Transaction name is now: WebTransaction/Other/OrderProduct
return View();
}
}
```

Este ejemplo muestra el uso de esta API en una aplicación de consola. Tenga en cuenta el `[Transaction]` atributo de instrumentación personalizada, que es necesario para crear una transacción para el método de ejemplo. La primera parte del nombre de la transacción seguirá siendo `OtherTransaction`.

```cs
NewRelic.Api.Agent.NewRelic.SetTransactionName("Other", "MyTransaction");
using NewRelic.Api.Agent;

namespace SetApplicationNameConsoleExample
{
internal class Program
{
static void Main(string[] args)
{
Console.WriteLine("Hello, World!");

var start = DateTime.Now;
while (DateTime.Now - start < TimeSpan.FromMinutes(2))
{
DoSomething();
Thread.Sleep(TimeSpan.FromSeconds(5));
}
}

[Transaction] // Attribute-based custom instrumentation to create a transaction for this method
static void DoSomething()
{
Console.WriteLine("Doing something: " + Guid.NewGuid().ToString());

// Transaction name from default naming at this point is: OtherTransaction/Custom/SetApplicationNameConsoleExample.Program/DoSomething
NewRelic.Api.Agent.NewRelic.SetTransactionName("Console", "MyCustomTransactionName");

// Transaction name at this point is: OtherTransaction/Console/MyCustomTransactionName
// Note, however, that this transaction will still have a child segment (span) named "SetApplicationNameConsoleExample.Program.DoSomething"
}
}
}
```
</Collapser>

Expand All @@ -2243,7 +2306,7 @@ La siguiente lista contiene las diferentes llamadas que puede realizar con la AP

### Descripción

Establece el URI de la transacción actual. El URI aparece en el atributo `request.uri` de [la traza de la transacción](/docs/apm/transactions/transaction-traces/transaction-traces) y [del evento de transacción](/docs/using-new-relic/metrics/analyze-your-metrics/data-collection-metric-timeslice-event-data), y también puede afectar el nombre de la transacción.
Establezca la URI de la transacción actual. El URI aparece en el atributo `request.uri` de [la traza de la transacción](/docs/apm/transactions/transaction-traces/transaction-traces) y [del evento de transacción](/docs/using-new-relic/metrics/analyze-your-metrics/data-collection-metric-timeslice-event-data), y también puede afectar el nombre de la transacción.

Si utiliza esta llamada varias veces dentro de la misma transacción, cada llamada sobrescribe la llamada anterior. La última llamada establece el URI.

Expand Down
225 changes: 212 additions & 13 deletions ...nt/es/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,37 @@ Aquí hay descripciones detalladas de cada método de configuración:

* Establezca la variable de entorno `NEW_RELIC_CONFIG_FILE` . Si utiliza el script contenedor `newrelic-admin` , debe usar la variable de entorno porque el script contenedor llama al agente automáticamente.

El archivo de configuración utiliza una estructura similar a los archivos `.ini` de Microsoft Windows. Para obtener más información, consulte la [documentación sobre el formato de archivo](http://docs.python.org/library/configparser.html) del módulo Python ConfigParser.
El agente admite dos tipos de archivos de configuración: el agente v10.2.0 y anteriores deben usar la sintaxis `.ini` , mientras que las versiones del agente v10.3.0 y superiores que se ejecutan en las versiones de Python 3.11 y superiores también admiten archivos `.toml` .

<Collapser className="freq-link" id="agent-configuration-file-ini" title="Formato del archivo de configuración `.ini`">
El archivo de configuración emplea una estructura similar a los archivos `.ini` de Microsoft Windows. Para obtener más información, consulte la [documentación del formato de archivo](https://docs.python.org/3/library/configparser.html) del módulo Python ConfigParser.

La estructura básica debería ver así:

```ini
[newrelic]
license_key = <license key>
app_name = Python Application
```
</Collapser>

<Collapser className="freq-link" id="agent-configuration-file-toml" title="Formato del archivo de configuración `.toml`">
<Callout variant="tip">
A partir de Python 3.11, se agregó la sintaxis más nueva `.toml` para la configuración a la [biblioteca estándar](https://docs.python.org/3/library/tomllib.html). La versión del agente `10.3.0` agregó soporte para usar este formato más nuevo.
</Callout>

El archivo de configuración emplea los archivos Obvious Minimal Language `.toml` de Tom. Para obtener más información, consulte la [documentación oficial del formato de archivo](https://toml.io/en/).

Para emplear la sintaxis `.toml` , el nombre del archivo de configuración debe terminar con `.toml` para indicar el tipo de sintaxis. El estándar `pyproject.toml` se puede emplear junto con la configuración de otra biblioteca, o puede emplear un archivo más específico como `newrelic.toml`.

La estructura básica debería ver así:

```ini
[tool.newrelic]
license_key = <license key>
app_name = Python Application
```
</Collapser>

<Callout variant="tip">
Se incluye un archivo de configuración de muestra con el agente Python como `newrelic/newrelic.ini`. También puede generar uno a partir del script `newrelic-admin` usando el comando `generate-config` o descargar una copia desde [nuestro repositorio de descargas](https://download.newrelic.com/python_agent/release/).
Expand Down Expand Up @@ -383,7 +413,7 @@ Aquí hay descripciones detalladas de cada método de configuración:

## Configuración de múltiples entornos [#config-file-deployment-environments]

El agente lee su configuración principal desde una sección de configuración del agente llamada `newrelic`. Puede proporcionar anulaciones para entornos de implementación específicos (por ejemplo, Desarrollo, prueba, Producción) en secciones adicionales. Anteponga estas secciones con `[newrelic:environment]`, donde `environment` se reemplaza con el nombre de su entorno.
El agente lee su configuración principal desde una sección de configuración del agente llamada `[newrelic]` para archivos `ini` , o `[tool.newrelic]` para archivos `.toml` . Puede proporcionar anulaciones para entornos de implementación específicos (por ejemplo, Desarrollo, de prueba, Producción) en secciones adicionales. Anteponga estas secciones con `[newrelic:environment]` para archivos `.ini` , o `[tool.newrelic.env.environment]` para archivos `.toml` (donde `environment` se reemplaza con el nombre de su entorno).

Para especificar que el agente debe utilizar una configuración basada en el entorno, utilice uno de estos métodos:

Expand All @@ -397,19 +427,37 @@ Si no se especifica ningún entorno, el agente utilizará la configuración pred

La estructura básica del archivo de configuración es:

```ini
[newrelic]
... default settings
<Collapser className="freq-link" id="config-file-format-example-ini" title="Formato del archivo de configuración `.ini`">
```ini
[newrelic]
... default settings

[newrelic:development]
... override settings
[newrelic:development]
... override settings

[newrelic:staging]
... override settings
[newrelic:staging]
... override settings

[newrelic:production]
... override settings
```
[newrelic:production]
... override settings
```
</Collapser>

<Collapser className="freq-link" id="config-file-format-example-toml" title="Formato del archivo de configuración `.toml`">
```ini
[tool.newrelic]
... default settings

[tool.newrelic.env.development]
... override settings

[tool.newrelic.env.staging]
... override settings

[tool.newrelic.env.production]
... override settings
```
</Collapser>

## Ajustes de configuración generales [#general-settings]

Expand Down Expand Up @@ -3897,6 +3945,150 @@ Para obtener algunos consejos sobre cómo configurar el log para el agente Pytho
</Callout>
</Collapser>

<Collapser id="application_logging.forwarding.custom_attributes" title="application_logging.forwarding.custom_attributes">
<table>
<tbody>
<tr>
<th>
Tipo
</th>

<td>
Cadena
</td>
</tr>

<tr>
<th>
Por defecto
</th>

<td>
(ninguno)
</td>
</tr>

<tr>
<th>
[Establecer en](#options)
</th>

<td>
Archivo de configuración, variable de entorno
</td>
</tr>

<tr>
<th>
[Variable ambiental](#environment-variables)
</th>

<td>
`NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES`
</td>
</tr>
</tbody>
</table>

Un hash con pares de valores principales para agregar como atributo personalizado a todos log de eventos reenviados a New Relic. El valor debe tener el siguiente formato: &quot;clave1:valor1;clave2:valor2&quot;
</Collapser>

<Collapser id="application_logging.forwarding.labels.enabled" title="application_logging.forwarding.labels.enabled">
<table>
<tbody>
<tr>
<th>
Tipo
</th>

<td>
Booleano
</td>
</tr>

<tr>
<th>
Por defecto
</th>

<td>
`false`
</td>
</tr>

<tr>
<th>
[Establecer en](#options)
</th>

<td>
Archivo de configuración, variable de entorno
</td>
</tr>

<tr>
<th>
[Variable ambiental](#environment-variables)
</th>

<td>
`NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED`
</td>
</tr>
</tbody>
</table>

Alterna si el agente agregará etiquetas a log para enviarlos a New Relic.
</Collapser>

<Collapser id="application_logging.forwarding.labels.exclude" title="application_logging.forwarding.labels.exclude">
<table>
<tbody>
<tr>
<th>
Tipo
</th>

<td>
Lista de cadenas
</td>
</tr>

<tr>
<th>
Por defecto
</th>

<td>
(ninguno)
</td>
</tr>

<tr>
<th>
[Establecer en](#options)
</th>

<td>
Archivo de configuración, variable de entorno
</td>
</tr>

<tr>
<th>
[Variable ambiental](#environment-variables)
</th>

<td>
`NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE`
</td>
</tr>
</tbody>
</table>

Una lista que no distingue entre mayúsculas y minúsculas de nombres de etiquetas que se excluirán cuando se habilita la inclusión de etiquetas en el registro. Este atributo no admite comodines ni expresiones regulares. <Callout variant="important">Al agregar etiquetas como atributo, el agente antepone las claves con `tags.`. Este prefijo <b>NO</b> se incluye cuando se comparan con las reglas de filtrado de exclusión.</Callout>
</Collapser>

<Collapser id="application_logging.forwarding.context_data.enabled" title="application_logging.forwarding.context_data.enabled">
<table>
<tbody>
Expand Down Expand Up @@ -5228,11 +5420,18 @@ Para deshabilitar la instrumentación predeterminada, proporcione una sección e

<CollapserGroup>
<Collapser id="example-disable-mysqldb" title="Ejemplo: deshabilitar la instrumentación de consulta de la base de datos MySQLdb">
Agregue lo siguiente al archivo de configuración:
Agregue lo siguiente al archivo de configuración `.ini` :

```ini
[import-hook:MySQLdb]
enabled = false
```

O para los archivos de configuración `.toml` agregue lo siguiente:

```ini
[tool.newrelic.import-hook.MySQLdb]
enabled = false
```
</Collapser>
</CollapserGroup>
Loading

0 comments on commit f5aba75

Please sign in to comment.