Guide d'utilisation de l'API C SDK

Le C SDK de New Relic monitore votre application et microservices pour vous aider à identifier et à résoudre les problèmes de performances. Application C exécutée à partir d'un fichier binaire natif compilé. Afin de monitorer les transactions, vous devez instrumenter manuellement votre code en y ajoutant des méthodes New Relic .

Ce guide vous aide à décider quelle méthode utiliser. Le code de la méthode, les paramètres requis et les exemples se trouvent dans la documentation du C SDK de New Relic sur GitHub.

Assurez-vous que votre personnalisation est thread-safe

Le C SDK prend en charge instrumentation d'applications multithread, mais il doit être initialisé avant d'instrumenter plusieurs threads. Lorsque vous appelez l’une des fonctions suivantes, assurez-vous qu’elles sont called on the main thread avant d’appeler toute autre fonction du C SDK :

• newrelic_configure_log
• newrelic_init

Monitorer les transactions

Avant d’ instrumenté manuellement votre code pour monitorer les transactions :

1. Vérifiez la compatibilité et les exigences du C SDK pour votre application.
2. Assurez-vous que vous utilisez la dernière version de la bibliothèque C SDK et mettez-la à jour si nécessaire.

Méthodes temporelles spécifiques utilisant des segments

Si une transaction est déjà visible dans New Relic, mais que vous ne disposez pas de suffisamment de données sur une méthode particulière qui a été appelée au cours de cette transaction, vous pouvez instrumenter des segments. Par exemple, si vous souhaitez chronométrer une méthode dotée d’une logique complexe, vous pouvez créer un segment pour chacune des méthodes de la transaction.

Pour instrumenter une méthode dans une transaction existante, créez des segments pour l’un des éléments suivants :

• Services externes
• Fonctions ou autres blocs de code arbitraires (utilisant des segments personnalisés)
• Magasins de données
• Traces de requête lentes (banques de données SQL uniquement)

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

Les segments sont enregistrés sur la transaction active. Lorsque vous ajoutez un segment à une transaction active, vous devez accéder au newrelic_txn_t* ou au pointeur de transaction, renvoyé par newrelic_start_web_transaction() ou newrelic_start_non_web_transaction().

Améliorer les métadonnées d'une transaction

Vous pouvez gérer les métadonnées que New Relic signale pour les transactions. Ceci est utile lorsque vous souhaitez un niveau de détail différent pour vos transactions. Par exemple:

• Si vous rencontrez un problème de regroupement métrique, vous pouvez modifier les noms par défaut de vos transactions pour les rendre plus identifiables.
• Si vous souhaitez créer dashboardspour vos transactions, vous pouvez ajouter un attribut personnalisé.

Instrumenter les appels à des services externes

Utilisez ces méthodes pour collecter des données sur les connexions de votre application à d’autres applications ou bases de données :

Collecter ou logger les erreurs

Le C SDK détecte automatiquement les erreurs. Si vous souhaitez modifier la manière dont les erreurs sont signalées à New Relic, modifiez la configuration du collecteur d'erreurs.

Envoyez des données personnalisées depuis votre application

Pour enregistrer des données personnalisées avec le C SDK, vous pouvez utiliser l’une des méthodes suivantes :

• Custom events: Chez New Relic, les données d’événement sont un type de données fondamental. Les données d'événement représentent un enregistrement d'un seul événement à un moment donné. Ceci est utile pour afficher ou interroger des détails spécifiques.
• Custom event attributes: Pour inclure des métadonnées supplémentaires sur l'événement, vous pouvez ajouter des paires de valeurs clés (attribut personnalisé) à votre événement personnalisé.
• Custom metrics: L'intervalle de temps métrique est la mesure statistique des données que New Relic agrège afin que vous puissiez les visualiser dans l'UI et les représenter graphiquement. Généralement, les données métriques ont une période de conservation plus longue que les données événementielles.

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

Voici quelques façons d’utiliser vos données personnalisées. Pour plus de détails sur le code et des exemples pour ces options, consultez la documentation des variables globales New Relic sur GitHub.

Monitorer les performances du navigateur de bureau

Pour monitorer les performances du navigateur de bureau pour votre application, installez l'agent de navigateur en utilisant la méthode copier/coller.

Modifier les paramètres de configuration

En règle générale, les paramètres par défaut de la configuration de votre application n'ont pas besoin d'être modifiés. Toutefois, si nécessaire, vous pouvez ajuster certains paramètres. Pour plus d'informations, consultez la documentation de configuration du C SDK.