Pour vous aider à créer des applications New Relic, nous vous fournissons les composants New Relic SDK, qui sont utilisés pour créer des applications New Relic.
Nous vous donnons ici une introduction aux types d'appel d'API et aux composants du SDK. Le SDK fournit tout ce dont vous avez besoin pour créer vos Nerdlets, créer des visualisations et récupérer des données New Relic ou tierces.
Composants du SDK
Vous pouvez trouver les composants SDK dans le package de module Node nommé nr1, que vous obtenez lorsque vous installez la CLI New Relic. Les composants nr1 sont divisés en plusieurs catégories :
- Composants de l'interface utilisateur
- Composants du graphique
- Composants de requête et de stockage
- API de la plateforme
Composants de l'interface utilisateur
La catégorie des composants d'interface utilisateur du SDK contient des composants d'interface utilisateur React, notamment :
Composants de texte: ces composants fournissent des éléments de police et de titre de base. Il s’agit notamment
HeadingTextetBlockText.Composants de mise en page: ces composants vous donnent le contrôle sur la mise en page et vous aident à créer des conceptions de mise en page complexes sans avoir à gérer le CSS. Les composants de mise en page comprennent :
GridetGridItem: pour organiser le contenu d'une page plus complexe et à plus grande échelle en lignes et en colonnes.StacketStackItem: pour organiser un contenu de page plus simple et à plus petite échelle, en colonne ou en ligne.TabsetTabsItem: regroupez divers éléments de contenu connexes dans des sections masquables distinctes.ListetListItem: pour fournir un squelette de base de listes virtualisées.Card,CardHeaderetCardBody: utilisés pour regrouper des concepts et des tâches similaires.
Composants de formulaire: ces composants fournissent les éléments de base pour interagir avec l'interface utilisateur. Il s’agit notamment de
Button,TextField,Dropdown,DropdownItem,Checkbox,RadioGroupetRadio.Composants de rétroaction: utilisez ces composants pour fournir des commentaires à l'utilisateur sur les actions qu'il a entreprises. Il s’agit notamment de :
SpinneretToast.Composants superposés: utilisez ces composants pour afficher des informations contextuelles et des options sous la forme d'une vue enfant supplémentaire qui apparaît au-dessus d'un autre contenu à l'écran lorsqu'une action ou un événement est déclenché. Ils peuvent soit nécessiter interaction utilisateur (comme les modaux), soit être augmentants (comme une info-bulle). Il s’agit notamment de :
ModaletTooltip.
Important
Les composants suffixés par Item ne peuvent fonctionner que comme enfants directs de ce nom sans le suffixe. Par exemple : GridItem ne doit être trouvé qu'en tant qu'enfant de Grid.
Composants du graphique
La catégorie Charts du SDK contient des composants représentant différents types de graphiques. Le composant ChartGroup permet à un groupe de graphiques associés de partager des données et de s'aligner.
Certains composants de graphique peuvent effectuer eux-mêmes des requêtes NRQL ; certains acceptent un ensemble de données personnalisé.
Composants de requête et de stockage
La catégorie Composants de requête (Query) contient des composants permettant de récupérer et de stocker les données New Relic.
Le principal moyen de récupérer des données est d'utiliser NerdGraph, notre point de terminaison GraphQL. Cela peut être une requête utilisant NerdGraphQuery. Pour simplifier l'utilisation de la requête NerdGraph, nous fournissons certains composants avec une requête prédéfinie. Consultez notre documentation sur NerdGraph pour plus d'informations.
Nous fournissons également un stockage pour stocker de petits ensembles de données, tels que des données de paramètres configuration ou des données spécifiques à l'utilisateur. Pour en savoir plus, consultez NerdStorage.
API de la plateforme
Les composants API de la plateforme du SDK permettent à votre application d'interagir avec différentes parties de la plateforme New Relic, en lisant et en écrivant l'état depuis et vers l'URL, en définissant la configuration, etc. Ils sont divisés en ces catégories :
PlatformStateContext: Fournit un accès en lecture aux variables d'état de l'URL de la plateforme. Par exempletimeRangedans le sélecteur d'intervalle de temps.navigation: Un objet qui permet la manipulation programmatique de la navigation dans New Relic. Exemple : ouvrir un nouveau Nerdlet.NerdletStateContext: fournit un accès en lecture aux variables d'état de l'URL Nerdlet. Par exemple unentityGuiddans l'explorateur d'entités.nerdlet: vous permet de configurer votre Nerdlet et d'écrire dans l'état de l'URL de votre Nerdlet.