Guía para utilizar la API del SDK de C

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:

• newrelic_configure_log
• newrelic_init

Monitor transacciones

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

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

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)

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

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

  dashboards

  para su transacción, puede agregar un atributo personalizado.

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:

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.

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.

// 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);

// 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);

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.

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.