• Log inStart now

Now that we've migrated this site's content to docs.newrelic.com, we're EOLing this site on June 21st 2024.

EntityByGuidQuery

Usage

import { EntityByGuidQuery } from 'nr1'

Examples

Props

childrenfunction

Render prop function as a child.

function (
queryResult: QueryResult

Results of the query.

) => React.ReactNode
entityFragmentExtensionobject

GraphQL fragment document parsed into an AST by graphql-tag.

The Query components return the most commonly used fields available on an entity. You can use this prop when you want to request additional fields for the entities returned by your query.

The fragment should be named EntityFragmentExtension and apply to the EntityOutline type.

entityGuidrequiredstring

GUID of the entity to query.

fetchPolicyTypeenum
DEFAULT
EntityByGuidQuery.FETCH_POLICY_TYPE.CACHE_AND_NETWORK

Allows you to specify how you want your query to interact with the cached data.

  • CACHE_AND_NETWORK: The query returns your initial data from the cache if available. However, regardless of whether or not the full data is in your cache, the query always makes a request using your network interface and returns the updated data. This option is not available when using the static query() method of the component.

  • CACHE_FIRST: The query makes a request using your network interface only if the data for your query is not already in the cache.

  • CACHE_ONLY: The query never makes a request using your network interface. Instead it returns the data available in the cache. If the data for your query does not exist in the cache, then an error is thrown.

  • NETWORK_ONLY: The query never returns your initial data from the cache. Instead it always makes a request using your network interface.

  • NO_CACHE: The query never returns your initial data from the cache. Instead it always makes a request using your network interface. Unlike the NETWORK_ONLY policy, it does not write any data to the cache after the query completes.

<One of
EntityByGuidQuery.FETCH_POLICY_TYPE.CACHE_AND_NETWORK,
EntityByGuidQuery.FETCH_POLICY_TYPE.CACHE_FIRST,
EntityByGuidQuery.FETCH_POLICY_TYPE.CACHE_ONLY,
EntityByGuidQuery.FETCH_POLICY_TYPE.NETWORK_ONLY,
EntityByGuidQuery.FETCH_POLICY_TYPE.NO_CACHE,
>
includeSummaryMetricsboolean
DEFAULT
false
includeTagsboolean
DEFAULT
true

If true, the returned entities include their tags.

pollIntervalnumber
DEFAULT
0

Interval in milliseconds to poll for new data. Set to zero to avoid any kind of regular polling.

skipboolean
DEFAULT
false

When set to true, the query will be skipped entirely from rendering.

Methods

EntityByGuidQuery.query

function (
props: Object

Object containing the query options. Any EntityByGuidQuery prop is a valid option except children and pollInterval.

) => PromiseQueryResult

Type definitions

PromiseQueryResult

{
error: ApolloClient.ApolloError,

Runtime error with graphQLErrors and networkError properties.

data: Object,

Object containing the result of your query.

fetchMore: function|null,

If not null, fetchMore allows you to load more results for your query. New data is merged with previous data.

refetch: function,

Refetch the query.

}

QueryResult

{
loading: boolean,

Indicates that the request is in flight.

error: ApolloClient.ApolloError,

Runtime error with graphQLErrors and networkError properties.

data: Object,

Object containing the result of your query.

fetchMore: function|null,

If not null, fetchMore allows you to load more results for your query. New data is merged with previous data.

refetch: function,

Refetch the query.

}
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.