• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Définir la plage horaire d'une requête

Nous avons créé NRQL pour requêter des données télémétriques, et chaque requête effectuée avec NRQL ne prend en compte que les données télémétriques qui se situent dans une plage de temps spécifiée. Si une requête ne spécifie pas de plage horaire, elle renvoie par défaut la dernière heure de données télémétriques. Heureusement, nous disposons de plusieurs moyens pour définir des plages de temps pour votre requête afin que vous puissiez obtenir exactement les données dont vous avez besoin à partir de plages de temps précises.

Spécifier une plage horaire

Vous pouvez utiliser deux méthodes pour spécifier la plage horaire dans votre requête :

  • Utilisez le dashboard sélecteur d'intervalle de temps. Lors de l'affichage d'un dashboard, la plage du sélecteur d'intervalle de temps remplace les clauses SINCE et UNTIL d'une requête, sauf si vous avez configuré le widget dashboard pour désactiver le sélecteur d'intervalle de temps.

  • Inclure SINCE et/ou UNTIL. Par exemple:

    FROM Foo SELECT * SINCE 2 days ago UNTIL 1 day ago

Consultez la section Spécification d’une heure ci-dessous pour obtenir une liste des formats d’heure pris en charge.

Utiliser la capture de plage de temps

Vous pouvez parfois ajuster les heures SINCE et UNTIL spécifiées en fonction du type de requête que vous exécutez avec un alignement de métrique ou de plage TIMESERIES .

Capture de requête métrique

Les requêtes avec événement métrique et certains exemples de types d'événements peuvent nécessiter d'ajuster la plage de temps en fonction des agrégations temporelles de cumul de la métrique. Par exemple:

FROM Metric SELECT sum(foo.count) SINCE '2023-12-20T00:04Z' UNTIL '2023-12-22T00:03Z'

En regardant la réponse JSON à cette requête, cette plage horaire de 47 heures et 59 minutes se résout en agrégations de temps métriques de 5 minutes, de sorte que la plage horaire réelle s'aligne sur les limites d'agrégation proches : "beginTime": "2023-12-20T00:00:00Z", "endTime": "2023-12-22T00:00:00Z".

TIMESERIES accrochage de requête

une requête avec TIMESERIES peut nécessiter d'ajuster la plage horaire afin que les résultats n'incluent pas un compartiment de séries chronologiques partielles. Par exemple:

FROM Foo SELECT count(*) TIMESERIES 5 minutes SINCE '2023-12-20T00:04:59Z' UNTIL '2023-12-21T00:03:12Z'

En examinant la réponse JSON à cette requête, les compartiments de séries chronologiques se basent sur la fin de la plage de temps et l'heure de début est ajustée de sorte que le premier compartiment de la réponse couvre 5 minutes complètes : "beginTime": "2023-12-20T00:08:12Z", "endTime": "2023-12-21T00:03:12Z".

Spécifiez une heure avec SINCE et UNTIL

Vous disposez de plusieurs façons de spécifier l'heure dans les clauses SINCE et until UNTIL .

Conseil

Pour chacune des options répertoriées ci-dessous, le fuseau horaire par défaut est UTC. Notez que le fuseau horaire préféré de l'utilisateur n'est pas utilisé pour l'exécution de la requête : la préférence de fuseau horaire de l'utilisateur affiche uniquement les valeurs DateTime.

Si vous souhaitez spécifier un fuseau horaire autre que UTC pour la plage horaire, vous pouvez l'inclure dans l'option de chaîne DateTime ou utiliser la clause WITH TIMEZONE de NRQL.

Heure Unix (Epoch Millisecondes)

L'heure peut être référencée comme l'heure Unix en millisecondes. Il s'agit du nombre de millisecondes écoulées depuis 1970-01-01T00:00:00Z, soit minuit le 1er janvier 1970. Par exemple:

FROM Foo SELECT * SINCE 1702899296789 UNTIL 1702902896789

Ces valeurs d'horodatage correspondent à une plage horaire commençant à 2023-12-18T11:34:56.789Z et se terminant à 2023-12-18T12:34:56.789Z.

Temps relatif (n [time units] ago)

Le temps relatif peut être référencé comme n [time units] ago avec les composants suivants :

  • n:Une valeur entière positive.
  • [time units]:Les unités de temps disponibles incluent milliseconds, seconds, minutes, hours, days, weeks, months (défini comme 30 jours), quarters (défini comme 91 jours) ou years (défini comme 365 jours). La pluralisation des unités de temps est facultative, vous pouvez donc laisser le « s » à la fin de l'unité. 2 day ago et 2 days ago ont la même signification.

Le temps est relatif au moment où vous exécutez la requête. Par exemple, supposons que vous ayez exécuté une requête sur 2023-12-18T12:34:56.789Z. Vous obtiendrez des résultats différents selon la valeur de temps relative que vous avez utilisée :

Référence temporelle relative

Heure de résolution (UTC)

NOW (temps d'exécution de la requête)

18/12/2023 12:34:56.789Z

2 milliseconds ago

2023-12-18T12:34:54.787Z

2 seconds ago

2023-12-18T12:34:54.789Z

2 minutes ago

2023-12-18T12:32:56.789Z

2 hours ago

2023-12-18T10:34:56.789Z

2 days ago

2023-12-16T12:34:56.789Z

2 weeks ago

2023-12-04T12:34:56.789Z

2 months ago

2023-10-19T12:34:56.789Z

2 quarters ago

2023-06-19T12:34:56.789Z

2 years ago

2021-18-12T12:34:56.789Z

Temps temporel relatif

Vous pouvez également utiliser le temps relatif en utilisant des références temporelles. Ces références temporelles relatives se résolvent au début de l'intervalle de temps temporel. Une référence temporelle relative honorera une clause WITH TIMEZONE . Sélectionnez un bouton ci-dessous pour voir plus d'informations sur des références temporelles spécifiques :

Utiliser une chaîne DateTime

Vous pouvez spécifier une plage horaire à l'aide d'une chaîne DateTime. L'analyseur prend généralement en charge le format DateTime ISO 8601 : '2023-12-18T12:34:56.789-06:00'. Mais l'analyseur DateTime peut également reconnaître des variantes du format standard ISO, comme '2023-12-18 12:34'. L'analyseur prend également en charge les chaînes de date uniquement ('2023-12-18') et d'heure uniquement ('12:34:56'). Nous avons les options et les exemples d'utilisation d'une chaîne DateTime ci-dessous :

Champ

Détails

Structure générale

[Date][Séparateur d'heure][Heure][Fuseau horaire][AM/PM]

Date

Année-Mois-Jour

  • Year - (obligatoire) Valeur de l'année à 4 chiffres.

  • Month - (obligatoire) Valeur du mois à 2 chiffres.

  • Day - (facultatif) Valeur du jour à 2 chiffres.

    Une chaîne DateTime peut inclure un Date sans heure, la valeur d'heure par défaut étant minuit au début de la date donnée. Les tirets entre les éléments de date sont facultatifs (mais recommandés), donc '20231218' est équivalent à '2023-12-18'.

Séparateur de temps

Sépare la date et l'heure dans une chaîne DateTime complète. Les valeurs de séparation valides sont la lettre majuscule T ou un seul espace.

Temps

Hour:Minute[[:Second].FractionalSecond]

  • Hour - (obligatoire) Valeur de l'heure à 1 ou 2 chiffres, 00-23. 2 chiffres sont recommandés, conformément à la spécification ISO 8601.

  • Minute - (obligatoire) Valeur des minutes à 2 chiffres, 00-59.

  • :Second - (facultatif) Valeur des secondes à 2 chiffres, 00-59.

  • [.FractionalSecond] - (facultatif) Valeur fractionnaire de seconde (millisecondes) à 1 à 3 chiffres, 000-999. Disponible uniquement lorsqu'une valeur :Second est incluse.

    Une chaîne DateTime peut inclure une heure sans date, la valeur de date par défaut étant le jour actuel. Lorsqu'une heure est donnée sans date dans la clause SINCE , si l'heure est dans le futur, le jour précédent sera utilisé pour la date.

    Lorsqu'une heure suit un T, les deux points sont facultatifs (mais recommandés). Si les deux points sont exclus, l'heure doit inclure 2 chiffres et AM/PM n'est pas autorisé. Ainsi, '20231218T123456.789' est équivalent à '2023-12-18T12:34:56.789'.

Fuseau horaire

Facultatif - Si TimeZone n'est pas inclus dans une chaîne DateTime, le fuseau horaire indiqué dans la clause WITH TIMEZONE de la requête sera utilisé s'il est présent, sinon le fuseau horaire UTC sera utilisé.

La valeur TimeZone peut éventuellement être précédée d'un espace. Il peut être indiqué sous différents formats.

  • Décalage - Indique les heures et les minutes du fuseau horaire par rapport à UTC.

    (+|-)Hours[:]Minutes - c'est à dire Plus ou moins, 2 chiffres des heures, deux points facultatifs et enfin 2 chiffres des minutes. La lettre Z est également prise en charge, représentant UTC ou un décalage de zéro.

    Exemples : -0600, Z, +0530, +05:30

  • ID de zone entre crochets - Un ID de zone est un nom textuel d'un fuseau horaire. La plupart des identifiants de zone (mais pas tous) se composent d'une région suivie d'une barre oblique, puis d'une sous-région. L’un des avantages de l’utilisation d’un ID de zone basé sur une région est que l’analyseur DateTime s’ajustera automatiquement aux règles d’heure d’été de la zone.

    Exemples : [America/Los_Angeles], [Etc/GMT-6], [UTC]

    Consultez la liste des identifiants de zone disponibles.

    Remarque : les identifiants de zone ne fonctionnent pas lorsque vous utilisez AM/PM.

AM/PM

AM ou PM peut être ajouté à la fin d'une chaîne DateTime. Si elle est présente, la valeur Hour est interprétée comme une valeur de 12 heures plutôt que comme une valeur de 24 heures, avec une plage de 01 à 12 au lieu de 00 à 23.

Remarque : AM/PM n’est pas pris en charge avec le format d’ID de zone TimeZone .

Fuseaux horaires

Identifiants de zone

Les identifiants de zone suivants sont valides pour la clause WITH TIMEZONE ou en tant que référence de fuseau horaire entre crochets dans une chaîne de date/heure (par exemple. '2023-12-18T12:34 [America/Los_Angeles]').

Droits d'auteur © 2025 New Relic Inc.
RecrutementConditions de servicePolitique DMCAAvis de confidentialitéCookiesLoi britannique sur l'esclavage

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