Guía para utilizar la API del SDK de C

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.

El C SDK de New Relic monitorea su aplicación y microservicios para ayudarlo a identificar y resolver problemas de rendimiento. La aplicación C se ejecuta desde un archivo binario nativo compilado. Para monitor la transacción, debe instrumentar manualmente su código agregando métodos New Relic.

Esta guía le ayudará a decidir qué método utilizar. El código del método, el parámetro requerido y los ejemplos se encuentran en la documentación C SDK de New Relic en GitHub.

Asegúrese de que su personalización sea segura para subprocesos

El SDK de C admite la instrumentación de aplicaciones multiproceso, pero debe inicializarse antes de instrumentar varios subprocesos. Al llamar a cualquiera de las siguientes funciones, asegúrese de que sean called on the main thread antes de llamar a cualquier otra función del SDK de C:

Monitor transacciones

Antes de instrumentar manualmente su código para monitor la transacción:

Verifique la compatibilidad y los requisitos de C SDK para su aplicación.
Asegúrese de estar utilizando la última versión de la biblioteca C SDK y actualícela según sea necesario.

Si quieres...	Utilice este método...
Comience a cronometrar una transacción web	`newrelic_start_web_transaction()`
Comience a cronometrar una transacción no web	`newrelic_start_non_web_transaction()`
Dejar de cronometrar una transacción	`newrelic_end_transaction()`
Evitar que una transacción se informe a New Relic	`newrelic_ignore_transaction()`

Métodos específicos de tiempo que utilizan segmentos

Si una transacción ya es visible en New Relic, pero no tiene suficientes datos sobre un método en particular que se llamó durante esa transacción, puede utilizar segmentos. Por ejemplo, si desea cronometrar un método que tiene una lógica compleja, puede crear un segmento para cada uno de los métodos de la transacción.

Para instrumentar un método dentro de una transacción existente, cree segmentos para cualquiera de los siguientes:

Servicios externos
Funciones u otros bloques de código arbitrarios (usando segmentos personalizados)
Almacenes de datos
Consulta lenta traza (solo almacenes de datos SQL)

Si quieres...	Utilice este método...
Comience a cronometrar un segmento	`newrelic_start_datastore_segment() newrelic_start_external_segment() newrelic_start_segment()`
Dejar de cronometrar un segmento	`newrelic_end_segment()`
Segmentos principales manualmente	`newrelic_set_segment_parent()` y `newrelic_set_segment_parent_root()` Esto es útil, por ejemplo, con un proceso asincrónico cuando desea visualizar un segmento como hijo de la llamada de nivel superior de la transacción. Para obtener más información, consulte la documentación de crianza de segmentos manual en GitHub.

Si quieres...

Utilice este método...

Comience a cronometrar un segmento

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

Dejar de cronometrar un segmento

newrelic_end_segment()

Segmentos principales manualmente

newrelic_set_segment_parent() y newrelic_set_segment_parent_root()

Esto es útil, por ejemplo, con un proceso asincrónico cuando desea visualizar un segmento como hijo de la llamada de nivel superior de la transacción. Para obtener más información, consulte la documentación de crianza de segmentos manual en GitHub.

Los segmentos se registran en la transacción activa. Al agregar un segmento a una transacción activa, necesita acceso al newrelic_txn_t* o puntero de transacción, devuelto por newrelic_start_web_transaction() o newrelic_start_non_web_transaction().

Mejorar los metadatos de una transacción

Puedes gestionar los metadatos que New Relic reporta para transacciones. Esto es útil cuando deseas un nivel diferente de detalle para tu transacción. Por ejemplo:

Si tiene un problema de agrupación métrica, puede cambiar los nombres predeterminados de su transacción para hacerlos más identificables.
Si desea crear
para su transacción, puede agregar un atributo personalizado.

Si quieres...	Utilice este método...
Agregue metadatos (como el nombre de la cuenta de sus clientes o el nivel de suscripción) a su transacción	Agregue un atributo personalizado a su transacción según su tipo: `newrelic_add_attribute_int()` `newrelic_add_attribute_string()` `newrelic_add_attribute_long()` `newrelic_add_attribute_double()`

Si quieres...

Utilice este método...

Agregue metadatos (como el nombre de la cuenta de sus clientes o el nivel de suscripción) a su transacción

Agregue un atributo personalizado a su transacción según su tipo:

Llamadas de instrumentos a servicios externos.

Utilice estos métodos para recopilar datos sobre las conexiones de su aplicación a otras aplicaciones o base de datos:

Si quieres...	Utilice este método...
Vea el camino que sigue una solicitud a medida que viaja a través de un sistema distribuido	Siga los procedimientos para habilitar el rastreo distribuido de instrumentos.
Cronometrar una llamada a un recurso externo (como un servicio externo, un servidor de base de datos o una cola de mensajes)	Siga los procedimientos para llamadas de instrumentos a segmentos externos.

Recopilar o log errores

El C SDK detecta errores automáticamente. Si desea cambiar la forma en que informa errores a New Relic, cambie la configuración del selector de errores.

Si quieres...	Utilice este método...
Establece niveles de registro para tu aplicación	Utilice `newrelic_configure_log()` para configurar el registro del SDK de C y los indicadores de línea de comando para configurar el registro daemon de C. Para obtener más información, consulte la documentación de registro del SDK de C.
Informar un error	`newrelic_notice_error()`

Envía datos personalizados desde tu aplicación

Para registrar datos personalizados con C SDK, puede utilizar cualquiera de los siguientes métodos:

Custom events:
En New Relic, los datos de eventos son un tipo de datos fundamental. Los datos de eventos representan un registro de un único evento en un momento particular en el tiempo. Esto es útil para ver o consultar detalles específicos.
Custom event attributes:
Para incluir metadatos adicionales sobre el evento, puede agregar pares de valores principales (atributo personalizado) a su evento personalizado.
Custom metrics:
Los datos de intervalo de tiempo de métrica son la medida estadística de datos que New Relic agrega para que pueda verlos en la UI y trazarlos. Normalmente los datos métricos tienen un período de retención más largo que los datos de eventos.

El SDK de C proporciona una API de eventos personalizados que le permite enviar eventos personalizados a New Relic. Para enviar un evento, inicie una transacción y utilice las funciones newrelic_create_custom_event y newrelic_record_custom_event . Por ejemplo:

// txn is a newrelic_txn_t*, created via newrelic_start_web_transaction
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");
newrelic_record_custom_event(txn, &custom_event);

Asegúrese de revisar los requisitos y límites de datos personalizados para obtener orientación sobre qué valores están y no están permitidos dentro de su evento personalizado. Para más información, consulte evento personalizado en APM.

Sugerencia

Si creó un evento personalizado pero necesita eliminarlo antes de que finalice la transacción, use newrelic_discard_custom_event(&custom_event);.

También puede agregar atributos int, long, double y char* (cadena) a su evento personalizado utilizando la familia de funciones newrelic_custom_event_add_* . Por ejemplo:

// Example custom attributes:
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");

newrelic_custom_event_add_attribute_int(custom_event, "keya", 42);
newrelic_custom_event_add_attribute_long(custom_event, "keyb", 84);
newrelic_custom_event_add_attribute_double(custom_event, "keyc", 42.42);
newrelic_custom_event_add_attribute_string(custom_event, "keyd", "A string");

newrelic_record_custom_event(txn, &custom_event);

Para obtener más información, consulte la documentación sobre atributo personalizado.

El SDK de C proporciona la función newrelic_record_custom_metric() . Esto le permite registrar datos de rendimiento basados en el tiempo mediante una llamada API, como por ejemplo:

Datos de tiempo de transacción
Datos de recursos informáticos
Datos de suscripción o compras
Para crear una métrica personalizada, proporcione un nombre u otro identificador y una cantidad de tiempo en milisegundos a la función, junto con la transacción activa.
Importante
Siempre preceda los nombres métricos personalizados con Custom/.
Por ejemplo:
```
// txn is a newrelic_txn_t*, created via newrelic_start_web_transaction

// Record a metric value of 100ms in the transaction txn
newrelic_record_custom_metric(txn, "Custom/MyMetric/My_label", 100);
```
Para más información, consulte Cobro métrico personalizado.

A continuación se muestran algunas formas de utilizar sus datos personalizados. Para obtener detalles del código y ejemplos de estas opciones, consulte la documentación global de New Relic en GitHub.

Si quieres...	Utilice este método...
Cree un evento personalizado para completar con una timestamp y un atributo.	`newrelic_create_custom_event()`
Timestamp y agregue el evento personalizado a la transacción actual para que pueda consultarla o visualizarla.	`newrelic_record_custom_event()`
Mejore su evento personalizado con metadatos adicionales.	Agregue un atributo de evento personalizado a su evento personalizado según el tipo: `newrelic_custom_event_add_attribute_double()` `newrelic_custom_event_add_attribute_int()` `newrelic_custom_event_add_attribute_long()` `newrelic_custom_event_add_attribute_string()`
Descarta un evento personalizado después de su creación, pero antes de que finalice su transacción, para evitar informarlo a New Relic.	`newrelic_discard_custom_event` Esto es necesario para liberar la memoria asignada para su evento personalizado no deseado a fin de evitar fugas en su programa.
Informe una duración de rendimiento personalizada que pueda buscar o trazar.	`newrelic_record_custom_metric()`

Monitor el rendimiento browser de escritorio

Para monitor el rendimiento del browser de escritorio para su aplicación, instale el agente del browser usando el método de copiar y pegar.

Cambiar los ajustes de configuración

Normalmente, no es necesario cambiar los valores predeterminados para la configuración de su aplicación. Sin embargo, cuando sea necesario, puede ajustar algunas de las configuraciones. Para obtener más información, consulte la documentación de configuración de C SDK.

Te ofrecemos esta traducción automática para facilitar la lectura.

Guía para utilizar la API del SDK de C

AVISO EOL

Asegúrese de que su personalización sea segura para subprocesos

Monitor transacciones

Métodos específicos de tiempo que utilizan segmentos

Mejorar los metadatos de una transacción

Llamadas de instrumentos a servicios externos.

Recopilar o log errores

Envía datos personalizados desde tu aplicación

Evento personalizado

Sugerencia

Evento personalizado atributo

Métrica personalizada

Importante

Monitor el rendimiento browser de escritorio

Cambiar los ajustes de configuración

Te ofrecemos esta traducción automática para facilitar la lectura.

Guía para utilizar la API del SDK de C

AVISO EOL

Asegúrese de que su personalización sea segura para subprocesos .css-21sua1{background:none;border:none;width:0;padding:0;}

Monitor transacciones

Métodos específicos de tiempo que utilizan segmentos

Mejorar los metadatos de una transacción

Llamadas de instrumentos a servicios externos.

Recopilar o log errores

Envía datos personalizados desde tu aplicación

Evento personalizado atributo

Métrica personalizada

Monitor el rendimiento browser de escritorio

Cambiar los ajustes de configuración

Asegúrese de que su personalización sea segura para subprocesos