Introduction à l'événement personnalisé et attribut

L'une des façons de signaler des données personnalisées à New Relic consiste à utiliser un événement personnalisé et/ou un attribut personnalisé.

Exigences

Pour connaître les exigences de formatage des événements et des attributs et les bonnes pratiques, consultez nos documents sur les limites et exigences des données.

Éviter les limites de taux

Signaler un grand nombre d'événements personnalisés et/ou d'attributs peut entraîner une dégradation des performances des requêtes. Cela peut également entraîner l'approche ou le dépassement des limites du taux de collecte de données. Pour des performances optimales, réfléchissez d’abord aux données que vous souhaitez analyser, puis créez uniquement l’événement et/ou l’attribut nécessaire pour atteindre ces objectifs spécifiques.

Tenez compte des exigences suivantes en matière de données et d’abonnement pour l’insertion et l’accès aux données personnalisées :

• Assurez-vous de respecter les limites et les exigences concernant les types de données d'événement/attribut, la syntaxe de dénomination et la taille.
• La quantité de données à laquelle vous avez accès au fil du temps dépend de votre politique de conservation des données.

Exemples de cas d'utilisation

Deux solutions populaires pour générer des rapports de données personnalisées sont le reporting événement personnalisé et l'attribut personnalisé. Il existe plusieurs façons d'y parvenir, en fonction de votre implémentation New Relic et de vos outils, et nous reviendrons plus en détail sur ce sujet plus loin dans ce document. Mais d’abord, voici quelques cas d’utilisation courants pour lesquels vous utiliseriez soit un événement personnalisé, soit un attribut personnalisé.

Cas d'utilisation de l'attribut personnalisé

Les attributs personnalisés sont souvent utilisés pour ajouter un contexte commercial et opérationnel important à un événement existant. Par exemple, pour New Relic monitoring de navigateurs, vous pouvez créer un attribut personnalisé pour suivre le nom d'utilisateur associé à une demande lente ou en échec. Cela vous permettrait ensuite de créer des requêtes et des graphiques personnalisés pour analyser ces données.

Les attributs personnalisés sont une bonne option lorsque vous utilisez une solution New Relic (comme APM, navigateur, monitoring d'applications mobiles, infrastructure et monitoring synthétique) et que vous souhaitez décorer un événement existant avec votre propre métadonnées.

Cas d'utilisation pour événement personnalisé

Alors que l'ajout d'un attribut personnalisé ajoute des métadonnées à un événement existant, un événement personnalisé crée un tout nouveau type d'événement. Créez des événements personnalisés pour définir, visualiser et recevoir des alertes sur des données supplémentaires, comme vous le feriez avec toutes les données que nous fournissons à nos agents principaux. L'événement personnalisé peut être inséré via notre API d'agent ou directement via notre API événement.

Les données d'événement sont l'un des quatre types de données principaux de New Relic. Nous vous recommandons de lire cette définition pour comprendre ce que nous entendons par « événement » et pourquoi ce type de données est le plus utilisé pour signaler des types d’activités spécifiques.

Les cas d’utilisation de l’événement personnalisé varient considérablement. Fondamentalement, ils sont utilisés pour tout type d’activité qu’une organisation juge importante et qui n’est pas déjà monitorée. Par exemple:

• Un événement peut représenter une activité impliquant plusieurs actions, comme l’achat par un client d’une certaine combinaison de produits.
• Un événement peut enregistrer une activité de sauvegarde. Par exemple, vous pouvez configurer des rapports d'événements représentant des sauvegardes de production d'une instance SOLR dans une table d'événements, avec un horodatage du moment où ils se sont produits, du cluster et de la durée.

Utiliser un événement personnalisé

Après avoir créé un événement personnalisé, vous pouvez l'utiliser dans une requête NRQL standard de la même manière que vous utiliseriez n'importe quel autre événement.

SELECT *
FROM YourCustomEvent

Vous pouvez également utiliser événement personnalisé avec l' explorateur métriques et événement en trouvant votre événement personnalisé dans l'interface et en les sélectionnant pour rédiger votre requête.

Envoyer événement personnalisé et attribut

Les méthodes d'envoi d'un événement personnalisé et d'un attribut incluent :

Pour d’autres options de création de rapports sur des données personnalisées, voir Données personnalisées.