EntitiesByNameQuery

Interroger les entités par leur nom.

Usage

import { EntitiesByNameQuery } from 'nr1'

Exemples

Requête déclarative

<EntitiesByNameQuery name="abc1-prod-metrics">
  {({ loading, error, data, fetchMore }) => {
    if (error) {
      return 'Error!';
    }


    return (
      <List
        items={data.entities}
        rowCount={data.count}
        rowHeight={20}
        onLoadMore={fetchMore}
      >
        {({ item }) => <ListItem key={item.guid}>{item.name}</ListItem>}
      </List>
    );
  }}
</EntitiesByNameQuery>

Récupérer avec des critères de tri

<EntitiesByNameQuery 
  name="abc1-prod-metrics"
  sortType={[EntitiesByNameQuery.SORT_TYPE.ALERT_SEVERITY]}
>
  {({ loading, error, data, fetchMore }) => {
    if (error) {
      return 'Error!';
    }


    return (
      <List
        items={data.entities}
        rowCount={data.count}
        rowHeight={20}
        onLoadMore={fetchMore}
      >
        {({ item }) => <ListItem key={item.guid}>{item.name}</ListItem>}
      </List>
    );
  }}
</EntitiesByNameQuery>

Requête impérative

EntitiesByNameQuery.query({
  name: 'abc1-prod-metrics',
}).then(({ data }) => console.log(data));

Récupérer plus de résultats à l'aide d'une requête impérative

const name = 'abc1-prod-metrics';
const firstPage = await EntitiesByNameQuery.query({ name });


console.log('First page data', firstPage.data);


const cursor = firstPage.data.nextCursor;
const secondPage = await EntitiesByNameQuery.query({ cursor, name });


console.log('Second page data', secondPage.data);


// NOTE: To fetch multiple page results consecutively, use EntitiesByNameQuery
// component's fetchMore approach.

Accessoires

children

fonction

Rendre la fonction prop comme un enfant.

function (queryResult: QueryResult Results of the query.
) => React.ReactNode

entityFragmentExtension

objet

Document fragment GraphQL analysé dans un AST par graphql-tag. Les composants de requête renvoient les champs les plus couramment utilisés disponibles sur une entité. Vous pouvez utiliser cet accessoire lorsque vous souhaitez demander des champs supplémentaires pour l'entité renvoyée par votre requête. Le fragment doit être nommé EntityFragmentExtension et s'appliquer au type EntityOutline.

const entityFragmentExtension = ngql`
  fragment EntityFragmentExtension on EntityOutline {
    indexedAt
    guid
  }
`;

fetchPolicyType

énum.

Vous permet de spécifier comment vous souhaitez que votre requête interagisse avec les données mises en cache.

CACHE_AND_NETWORK: La requête renvoie vos données initiales du cache si elles sont disponibles. Cependant, que les données complètes soient ou non dans votre cache, la requête effectue toujours une demande à l'aide de votre interface réseau et renvoie les données mises à jour. Cette option n'est pas disponible lors de l'utilisation de la méthode statique query() du composant.
CACHE_FIRST: La requête effectue une demande à l'aide de votre interface réseau uniquement si les données de votre requête ne sont pas déjà dans le cache.
CACHE_ONLY: La requête n'effectue jamais de demande à l'aide de votre interface réseau. Au lieu de cela, il renvoie les données disponibles dans le cache. Si les données de votre requête n'existent pas dans le cache, une erreur est générée.
NETWORK_ONLY: La requête ne renvoie jamais vos données initiales à partir du cache. Au lieu de cela, il fait toujours une demande en utilisant votre interface réseau.
NO_CACHE: La requête ne renvoie jamais vos données initiales à partir du cache. Au lieu de cela, il fait toujours une demande en utilisant votre interface réseau. Contrairement à la politique NETWORK_ONLY, aucune donnée n'est écrite dans le cache une fois la requête terminée.
<One ofEntitiesByNameQuery.FETCH_POLICY_TYPE.CACHE_AND_NETWORK, EntitiesByNameQuery.FETCH_POLICY_TYPE.CACHE_FIRST, EntitiesByNameQuery.FETCH_POLICY_TYPE.CACHE_ONLY, EntitiesByNameQuery.FETCH_POLICY_TYPE.NETWORK_ONLY, EntitiesByNameQuery.FETCH_POLICY_TYPE.NO_CACHE, >

filters

chaîne

|(forme|forme|forme)[]

Filtres utilisés pour affiner l'entité. Il s'agit d'un éventail de filtres, et il existe 3 filtres possibles :

SearchQueryFilter: : Object<type: string = "searchQuery", value: string>
EntityTypeFilter : Object<type: string = "entityType", Object<domain: string, type: string>>

TagFilter : Object<type: string = "tag", Object<key: string, value: string>>

const filters = [   {     type: 'searchQuery',     value: 'foo',   },   {     type: 'entityType',     value: { domain: 'APM', type: 'APPLICATION' },   },   {     type: 'tag',     value: { key: 'environment', value: 'production' },   },   {     type: 'tag',     value: { key: 'team', value: 'bar' },   }, ];

includeSummaryMetrics

booléen

includeTags

booléen

Si true, l'entité renvoyée inclut sa balise.

limit

nombre

Pagination, nombre d'entités à récupérer sur chaque page.

name

OBLIGATOIRE

chaîne

Nom ou nom partiel des entités à interroger.

pollInterval

nombre

Intervalle en millisecondes pour interroger de nouvelles données. Réglez à zéro pour éviter tout type d'interrogation régulière.

skip

booléen

Lorsqu'il est défini sur true, la requête sera entièrement ignorée du rendu.

sortBy

OBSOLÈTE

Date limite de soumission : 1er novembre 2023

Le sortBy est obsolète, utilisez plutôt sortType

sortType

énumération[]

Éventail de critères utilisés pour trier les résultats de recherche d'entités.

<Array of<One ofEntitiesByNameQuery.SORT_TYPE.ALERT_SEVERITY, EntitiesByNameQuery.SORT_TYPE.DOMAIN, EntitiesByNameQuery.SORT_TYPE.MOST_RELEVANT, EntitiesByNameQuery.SORT_TYPE.NAME, EntitiesByNameQuery.SORT_TYPE.REPORTING, EntitiesByNameQuery.SORT_TYPE.TYPE,
>
>

Méthodes