Skip to content

Commit

Permalink
Merge pull request #16637 from newrelic/translations-cb90771e
Browse files Browse the repository at this point in the history
Translations cb90771
  • Loading branch information
clarkmcadoo committed Mar 22, 2024
2 parents a308721 + 1ff73ca commit 2f2fa72
Show file tree
Hide file tree
Showing 490 changed files with 132,327 additions and 1,210 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
---
title: 'Seguridad APM: SDK de C'
tags:
- Agents
- C SDK
- Get started
metaDescription: How the C SDK ensures that the data sent from your application to be monitored by New Relic is secure.
freshnessValidatedDate: never
translationType: machine
---

<Callout
variant="important"
title="AVISO EOL"
>
A partir de abril de 2022, no admitimos la capacidad C SDK. Para obtener más detalles, consulte nuestra [publicación en el foro de soporte](https://discuss.newrelic.com/t/q1-bulk-eol-announcement-fy23/181744).
</Callout>

Debido a la naturaleza del SDK de C, usted tiene control directo sobre qué datos se reportan a New Relic. Para garantizar la privacidad de los datos y limitar los tipos de información que recibe New Relic, no se capturan datos de los clientes excepto los que usted proporciona en su API de llamada. Además, C SDK informa todos los datos a New Relic a través de HTTPS.

Para obtener más información sobre nuestras medidas de seguridad, consulte nuestra [documentación de seguridad y privacidad](/docs/using-new-relic/new-relic-security/security/security-matters-data-privacy-new-relic) o visite el [sitio web de seguridad de New Relic](https://newrelic.com/security).

## Configuración de seguridad predeterminada [#default]

De forma predeterminada, así es como el SDK de C maneja los siguientes datos potencialmente confidenciales. Para obtener más información, incluidos valores de código y ejemplos, consulte la [documentación del SDK de C sobre estructuras de datos en GitHub](https://newrelic.github.io/c-sdk/annotated.html).

<table>
<thead>
<tr>
<th width="200px">
Tipo de información
</th>

<th>
C SDK seguridad de los datos
</th>
</tr>
</thead>

<tbody>
<tr id="name">
<td>
Nombre de la instancia de almacenamiento de datos o nombre de la base de datos
</td>

<td>
[`newrelic_datastore_segment_config_t`](https://newrelic.github.io/c-sdk/structnewrelic__datastore__segment__config__t.html) es una estructura que configura si el nombre de la instancia y el nombre de la tabla de un almacenamiento de datos se capturan para la instrumentación del segmento de almacenamiento de datos.

* <DoNotTranslate>**Instance names:**</DoNotTranslate>

De forma predeterminada, la configuración devuelta por `newrelic_new_config()` habilita segmentos de almacenamiento de datos con `instance_reporting` establecido en `true`.

* <DoNotTranslate>**Database names:**</DoNotTranslate>

De forma predeterminada, la configuración devuelta por `newrelic_new_config()` habilita segmentos de almacenamiento de datos con `database_name_reporting` establecido en `true`.
</td>
</tr>

<tr id="sql">
<td>
SQL
</td>

<td>
La configuración `record_sql` en [`newrelic_transaction_tracer_config_t`](https://newrelic.github.io/c-sdk/structnewrelic__transaction__tracer__config__t.html) controla el formato SQL en la traza de la transacción para productos similares a SQL compatibles. La configuración predeterminada, `NEWRELIC_SQL_OBFUSCATED`, establece los caracteres alfanuméricos en `?`.
</td>
</tr>

<tr id="audit-mode">
<td>
[Modo de auditoría](/docs/agents/manage-apm-agents/configuration/log-audit-all-data-your-new-relic-agent-transmits)
</td>

<td>
El log de auditoría es un registro de texto sin formato de todos los datos enviados a New Relic por el C SDK. Al [iniciar el daemonC SDK](/docs/agents/c-sdk/install-configure/install-c-sdk-compile-link-your-code#daemon), agregue `-auditlog <file>` al archivo de configuración daemon . Por ejemplo:

```sh
./newrelic-daemon -f -logfile stdout -loglevel debug -auditlog audit.log
```

<Callout variant="tip">
Para ver todas las opciones disponibles para el daemon C: En la línea de comando, escriba:

```sh
./newrelic-daemon --help
```
</Callout>
</td>
</tr>
</tbody>
</table>

## Personalizar la configuración de seguridad [#customize]

Si la configuración predeterminada no funciona para las necesidades de su negocio, puede personalizar cómo se envía la información a New Relic modificando [`newrelic_datastore_segment_config_t`](https://newrelic.github.io/c-sdk/structnewrelic__datastore__segment__config__t.html) y [`newrelic_transaction_tracer_config_t`](https://newrelic.github.io/c-sdk/structnewrelic__transaction__tracer__config__t.html).

<Callout variant="caution">
Si personaliza su configuración, puede afectar la seguridad de su aplicación.
</Callout>
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
title: Compatibilidad y requisitos de C SDK
tags:
- Agents
- C SDK
- Get started
metaDescription: 'Before you install the New Relic C SDK, make sure your application meets these compatibility requirements.'
freshnessValidatedDate: never
translationType: machine
---

<Callout
variant="important"
title="AVISO EOL"
>
A partir de abril de 2022, no admitimos la capacidad C SDK. Para obtener más detalles, consulte nuestra [publicación en el foro de soporte](https://discuss.newrelic.com/t/q1-bulk-eol-announcement-fy23/181744).
</Callout>

El C SDK de New Relic proporciona una biblioteca genérica que puede personalizar para comunicarse con New Relic. Antes de instalar el C SDK de New Relic, asegúrese de que su sistema cumpla con estos requisitos. Consulte también la [documentación de licencias de C SDK](/docs/c-sdk-licenses).

¿Quieres probar nuestro C SDK? ¡ [Crea una cuenta New Relic](https://newrelic.com/signup) gratis! No se requiere tarjeta de crédito.

## Versiones de idiomas [#language-release]

El SDK de C le permite instrumentar cualquier aplicación en Linux, siempre que:

* Debes tener acceso al código fuente.
* El idioma de destino debe poder importar la biblioteca C.

Puede utilizar el SDK de C para crear instrumentación para aplicaciones escritas en C y C++. También puedes usarlo en lenguajes como Perl, que se implementan en C o C++, y en cualquier lenguaje que tenga una interfaz de función externa con C.

## Entornos operativos [#operating-systems]

El C SDK funciona en sistemas operativos Linux de 64 bits con:

* gcc 4.8 o superior
* glibc 2.17 o superior
* Versión del kernel 2.6.26 o superior
* libpcre 8.20 o superior
* libpthread
* cmake 2.8 o superior

Para compilar el daemon New Relic se requiere Go 1.7 o superior.

## Clave de licencia [#license]

Necesitará una New Relic <InlinePopover type="licenseKey"/>para la cuenta a la que desea informar datos.

## Tipo de procesador [#processor]

* Solo plataforma Intel (y compatible)
* Se requiere soporte para instrucciones SSE2

## Requerimientos de seguridad [#security]

Como [medida de seguridad estándar para la recopilación de datos](/docs/accounts-partnerships/new-relic-security/security/data-security), su servidor de aplicaciones debe admitir SHA-2 (256 bits). SHA-1 no es compatible.

## Rendimiento a nivel de instancia y base de datos [#datastores]

Puede recopilar [detalles de instancia para una variedad de base de datos y controlador de la base de datos](/docs/apm/applications-menu/features/analyze-database-instance-level-performance-issues). También puede ver los detalles de consulta lenta traza para la siguiente plataforma de base de datos basada en SQL:

* Firebird
* Informix
* Servidor Microsoft SQL
* MySQL
* Oracle
* Postgres
* SQLite
* Sybase
Original file line number Diff line number Diff line change
@@ -0,0 +1,192 @@
---
title: Alternativa a OpenTelemetry del SDK de C
tags:
- Agents
- C SDK
- Get started
- OpenTelemetry
metaDescription: Explore OpenTelemetry to send your C++ instrumentation data to New Relic.
freshnessValidatedDate: never
translationType: machine
---

OpenTelemetry C++ es una interesante [solución](https://github.com/open-telemetry/opentelemetry-cpp) de observabilidad con funcionalidad estable y una amplia base de contribuyentes en una base de código activa. New Relic es [compatible](/docs/integrations/open-source-telemetry-integrations/opentelemetry/introduction-opentelemetry-new-relic/) con OpenTelemetry y los [beneficios](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-introduction/) que puede proporcionar, como código preparado para el futuro al realizar llamadas de instrumentación independientes del punto final en lugar de adherirse a formatos específicos del proveedor.

Consulte la [configuración de New Relic OpenTelemetry](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/) para obtener instrucciones detalladas sobre cómo usar OpenTelemetry para trabajar con el idioma de su elección para enviar datos a New Relic.

El repositorio OpenTelemetry C++ tiene muchos buenos [ejemplos en GitHub](https://github.com/open-telemetry/opentelemetry-cpp/tree/main/examples). Consulte [CONTRIBUTING.md](https://github.com/open-telemetry/opentelemetry-cpp/blob/main/CONTRIBUTING.md) para obtener más instrucciones sobre cómo crear y utilizar el SDK de OpenTelemetry C++, así como sobre cómo crear y ejecutar los ejemplos.

## Ejemplo de inicio rápido [#quick-start]

¿Quiere comenzar de inmediato y ver qué puede hacer New Relic sin tener que modificar su código? Siga los pasos a continuación para ver un ejemplo que le permitirá enviar datos a New Relic en poco tiempo.

Cuando esté listo para comenzar a instrumentar, consulte las [instrucciones de configuración de New Relic OpenTelemetry](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/) y el repositorio de OpenTelemetry C++ [CONTRIBUTING.md](https://github.com/open-telemetry/opentelemetry-cpp/blob/main/CONTRIBUTING.md) para obtener más detalles sobre la integración con su código.

### 1. Configura tu entorno [#environment]

Asegúrese de tener los requisitos previos descritos en la [documentación de New Relic OpenTelemetry](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/#prereqs).

1. Ejecute `git clone https://github.com/open-telemetry/opentelemetry-cpp`.
2. Copie los archivos de ejemplo `Dockerfile.ubuntu`, `docker-compose-collector.yaml` y `config.dev.yaml` en la raíz del directorio clonado en el paso 1.
3. Edite `config.dev.yaml` con su [clave de licencia](/docs/apis/intro-apis/new-relic-api-keys/#ingest-license-key) y [extremo](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/#review-settings).
4. Ejecute `docker-compose -f docker-compose-collector.yaml up`.
5. Verifique que los dos contenedores se estén ejecutando, uno para el recolector y otro para la aplicación C++.

### 2. Ejecute la aplicación C++ [#run-app]

Abra una terminal en el contenedor C++ y ejecute los siguientes comandos:

1. `cd /usr/src/myapp`
2. `mkdir build`
3. `cd build`
4. `rm -rf *`

```bash
cmake -DCMAKE_BUILD_TYPE=Debug \
-DWITH_METRICS_PREVIEW=ON \
-DWITH_LOGS_PREVIEW=ON \
-DCMAKE_CXX_FLAGS="-Wno-error=deprecated-declarations" \
-DWITH_OTLP=ON \
..
```

5. `cd examples`
6. `make`
7. `cd otlp`
8. `./example_otlp_http`

### 3. Ver tus datos [#view-data]

Verifique que los datos hayan llegado consultando los datos de su cuenta New Relic:

1. Para ver datos de intervalo: vaya a

<DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Query your data**</DoNotTranslate>

e ingrese esta consulta:

```sql
FROM Span SELECT * where telemetry.sdk.name = 'opentelemetry'
```

2. Vea el [servicio OpenTelemetry](/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-view-your-data#explorer) buscando `unknown_service` para obtener más detalles.

## Archivos de muestra [#sample-files]

### docker-compose-collector.yaml

```yaml
version: '3.7'
services:
cpp:
build:
context: .
dockerfile: Dockerfile.ubuntu
stdin_open: true
environment:
- OTEL_EXPORTER_OTLP_ENDPOINT=otel-collector:4318
volumes:
- ./:/usr/src/myapp
otel-collector:
image: otel/opentelemetry-collector-contrib
stdin_open: true
command: ["--config=/etc/otel-collector-config.yml"]
volumes:
- ./config.dev.yaml:/etc/otel-collector-config.yml
ports:
- "1888:1888" # pprof extension
- "8888:8888" # Prometheus metrics exposed by the collector
- "8889:8889" # Prometheus exporter metrics
- "13133:13133" # health_check extension
- "9411" # Zipkin receiver
- "4317:4317" # OTLP gRPC receiver
- "4318:4318" # OTLP http receiver
- "55680:55679" # zpages extension
depends_on:
- cpp
```

### Dockerfile.ubuntu

```dockerfile
FROM ubuntu:20.04
ENV DEBIAN_FRONTEND noninteractive

## Update cache and upgrade image
RUN apt-get -y update && apt-get -y upgrade && apt-get -y dist-upgrade

## Build environment packages
RUN apt-get install -qq -y --ignore-missing \
apt-utils \
automake \
bc \
build-essential \
bzip2 \
cmake \
curl \
git \
libcurl4-openssl-dev \
libssl-dev \
libtool-bin \
make \
pkg-config \
protobuf-compiler \
libprotobuf-dev \
python \
sudo \
tar \
zip \
unzip \
wget \
zlib1g-dev

WORKDIR /setup-tools

ADD ci/setup_ci_environment.sh /setup-tools
ADD ci/setup_cmake.sh /setup-tools
ADD ci/install_protobuf.sh /setup-tools

RUN /setup-tools/setup_ci_environment.sh \
&& /setup-tools/setup_cmake.sh \
&& /setup-tools/install_protobuf.sh

WORKDIR /usr/src/myapp

# ENTRYPOINT bash
CMD /bin/bash
```

### config.dev.yaml

```yaml
exporters:
newrelic:
apikey: 'EDIT_TO_ADD_YOUR_KEY_HERE'
timeout: 30s
host_override: "otlp.nr-data.net"
logging:
loglevel: DEBUG
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
cors:
allowed_origins:
- '*'
service:
pipelines:
traces:
receivers:
- otlp
exporters:
- logging
- newrelic
logs:
receivers:
- otlp
exporters:
- logging
```

0 comments on commit 2f2fa72

Please sign in to comment.