Berichte

Mit CQL filtern

Schreiben Sie einen Kostenfilter als eine Zeile CQL, der Costfluent Query Language, einschließlich OR, das Filterbedingungen nicht ausdrücken können.

CQL, die Costfluent Query Language, schreibt einen Kostenfilter als eine Zeile Text:

Code
(costs.provider = 'aws' AND costs.service = 'Amazon Elastic Compute Cloud') OR costs.region LIKE 'eu-%'

CQL ist eine zweite Schreibweise desselben Filters, den die Filterbedingungen eines Berichts bilden, und kann Bedingungen zusätzlich mit OR verbinden. Überall, wo ein Kostenfilter angenommen wird, wird auch CQL angenommen: in Kostenberichten, Regeln virtueller Tags, gespeicherten Filtern, der Public API und dem Terraform-Provider. Costfluent speichert jeden Filter als sein JSON-Dokument und gibt ihn in dieser Form zurück, auch gespeicherte Filter und Kostenwarnungen.

Bevor Sie beginnen

  • Ein Workspace mit mindestens einer verbundenen Quelle, damit es Kostenwerte gibt, die passen können.
  • Werte unterscheiden Groß- und Kleinschreibung und müssen den Werten entsprechen, die eine Filterbedingung auflistet, außer mit ~* und !~*, die Groß- und Kleinschreibung, Leerzeichen, Bindestriche und Unterstriche übergehen. Wählen Sie in einem Bericht Filter hinzufügen, öffnen Sie die Werte der Bedingung und übernehmen Sie einen genau: Die Liste zeigt die Werte mit Kosten im Zeitraum des Berichts, die größten zuerst, und ihr Suchfeld findet auch weiter unten liegende.
  • Ein Anbieter wird mit seinem Schlüssel geschrieben, etwa aws, azure, gcp oder kubernetes, demselben Schlüssel, den die Public API zurückgibt. Der Name des Anbieters, etwa Amazon Web Services, ist ein eigenes Feld, costs.provider_name.

Einen Filter in einem Bericht schreiben

  1. Öffnen Sie einen Bericht unter Kostenberichte und wählen Sie Als Text bearbeiten neben Filter hinzufügen, über dem Diagramm.
  2. Das Feld Filter als CQL zeigt den aktuellen Filter als CQL-Text, unter einer Zeile, die sagt, dass CQL Bedingungen auch mit OR verbinden kann. Bearbeiten Sie ihn oder schreiben Sie einen neuen Filter.
  3. Wählen Sie Anwenden, oder drücken Sie Strg+Enter (⌘+Enter auf einem Mac). Der Bericht wird aktualisiert, und der Filter bleibt als nicht gespeicherte Änderung in der Seitenadresse erhalten; Änderungen speichern behält ihn im Bericht. Siehe Berichte speichern und verwalten.

Lässt sich der Text nicht lesen, zeigt das Feld den Grund und nennt die Zeichenposition, etwa Unknown field 'costs.colour' mit (at position 34) am Ende, und der aktuelle Filter bleibt bestehen. CQL-Referenz im Feld öffnet diese Seite.

Ein Filter mit OR hat keine Form als Bedingungen. Für einen solchen Filter treten die Bedingungen zurück, und das Feld Filter als CQL ist der Editor. Eine Bedingung mit mehreren Mustern, geschrieben als LIKE ANY (...), zeigt ihre Werte nur lesend, weil das einzelne Wertefeld der Bedingung nur das erste behalten würde.

Felder

CQLFilterfeld
costs.providerAnbieter
costs.provider_nameAnbietername
costs.account_idUnterkonto
costs.account_nameName des Unterkontos: der Name, den die Rechnung dem Konto gibt
costs.serviceDienst
costs.regionRegion
costs.resource_nameRessource
costs.resource_groupRessourcengruppe: die Azure-Ressourcengruppe, gelesen aus der Ressourcen-ID
costs.charge_categoryKostenkategorie: Usage, Purchase, Tax, Credit oder Adjustment
costs.clusterCluster
costs.namespaceNamespace
costs.provider_account_idAbrechnungskonto
costs.provider_account_nameName des Abrechnungskontos: der Name, den die Rechnung dem Konto gibt, nie der Name einer Verbindung, den ein Bericht neben seiner ID zeigen kann
costs.categoryDienstkategorie
costs.subcategoryDienstunterkategorie
costs.usage_unitNutzungseinheit
costs.charge_classKostenklasse: Correction für eine Gebühr, die einen früheren Zeitraum korrigiert
costs.resource_idRessourcen-ID
costs.commitment_statusCommitment-Status: Used oder Unused
costs.commitment_typeCommitment-Typ: SavingsPlan, ReservedInstance oder CommittedUseDiscount
costs.commitment_idCommitment: die ID des Anbieters dafür, etwa die ARN eines Savings Plans
costs.pricing_categoryPreiskategorie: Standard, Dynamic, Committed oder Other, bei einer Steuer keine
costs.skuSKU: die Bezeichnung des Anbieters für das Abgerechnete, oder die SKU-ID einer Zeile ohne Bezeichnung
costs.sku_idSKU-ID: die ID des Anbieters für das Abgerechnete
costs.operationVorgang: der abgerechnete AWS-Vorgang, etwa RunInstances
costs.charge_descriptionKostenbeschreibung: der Text, den die Rechnung selbst für die Zeile führt
costs.resource_typeRessourcentyp: die Art der abgerechneten Ressource, wie der Anbieter sie nennt
costs.product_familyProduktfamilie: die Dienstfamilie von Azure, etwa Compute
costs.invoice_idRechnungs-ID: die Rechnung des Anbieters, auf der die Zeile abgerechnet wird
costs.invoice_issuerRechnungssteller: die juristische Person des Anbieters, die die Zeile in Rechnung stellt, etwa Amazon Web Services EMEA SARL
costs.billing_periodAbrechnungszeitraum: der abgerechnete Monat, geschrieben YYYY-MM, etwa '2026-03'
costs.taggedGetaggt: 'true' für eine Zeile mit einem Tag, den Costfluent nicht selbst hinzugefügt hat, 'false' für eine nicht getaggte (Kostendaten untersuchen nennt die Schlüssel, die Costfluent hinzufügt)
costs.tag_complianceTag-Compliance: 'compliant' für eine Zeile, die jeden Schlüssel trägt, den die Tag-Richtlinie des Workspace für ihren Anbieter und ihr Konto verlangt, 'non_compliant' für eine Zeile, der einer fehlt
tags->>'key'Tag, mit seinem Tag-Schlüssel
virtual_tags->>'vtag_...'Virtueller Tag, benannt durch seine ID
costs.segmentSegment, benannt durch seine ID (seg_...): die Kosten, die Ihre Zuordnungsregeln dem Segment zuordnen, plus sein Anteil an den geteilten Kosten

Operatoren

SchreibweiseBedeutung
f = 'v'ist eines von v
f != 'v' oder f <> 'v'ist keines von v
f IN ('a', 'b') / f NOT IN ('a', 'b')ist eines von / ist keines von
f LIKE '%v%' / 'v%' / '%v'enthält / beginnt mit / endet mit
f NOT LIKE '%v%' / 'v%' / '%v'enthält nicht / beginnt nicht mit / endet nicht mit
f LIKE 'v' / f NOT LIKE 'v'ist eines von / ist keines von v
f LIKE ANY ('a%', 'b%')passt auf mindestens ein Muster
f NOT LIKE ALL ('a%', 'b%')passt auf keines der Muster
f LIKE ALL (...) / f NOT LIKE ANY (...)eine Bedingung je Muster, verbunden mit AND / OR
f ~* 'v' / f !~* 'v'entspricht flexibel / entspricht nicht flexibel v: gleich, wenn Groß- und Kleinschreibung, Leerzeichen, Bindestriche und Unterstriche übergangen werden
f ~* ANY ('a', 'b') / f !~* ALL ('a', 'b')entspricht flexibel mindestens einem / keinem der Werte
f ~* ALL (...) / f !~* ANY (...)eine Bedingung je Wert, verbunden mit AND / OR
f = NULL / f != NULLhat keinen Wert / hat einen Wert
tags.name = NULL / tags.name != NULLnicht getaggt / getaggt, dasselbe wie costs.tagged = 'false' / 'true'

Verbinden Sie Bedingungen mit AND, OR und Klammern, so tief verschachtelt wie nötig. AND bindet stärker als OR. Schlüsselwörter und Feldnamen unterscheiden keine Groß- und Kleinschreibung, Werte schon, außer mit ~* und !~*.

Setzen Sie Werte in einfache Anführungszeichen und schreiben Sie ein Anführungszeichen innerhalb eines Werts doppelt: tags->>'owner' = 'o''neil'. In einem LIKE-Muster ist % nur am Anfang oder Ende ein Platzhalter, _ ist ein gewöhnliches Zeichen, und \% ist ein wörtliches Prozentzeichen.

Beispiele

Kosten zweier Dienste außerhalb einer Region:

Code
costs.service IN ('Amazon Elastic Compute Cloud', 'Amazon Simple Storage Service') AND costs.region != 'us-east-1'

Kosten mit Produktions-Tag oder alles in einem Kubernetes-Namespace, der mit payments beginnt:

Code
tags->>'Environment' = 'production' OR costs.namespace LIKE 'payments%'

Ein Filter in Vantage VQL wie costs.provider = 'aws' AND tags.name = 'team' AND tags.value = 'platform' behält in CQL seinen Anbieter und schreibt den Tag anders:

Code
costs.provider = 'aws' AND tags->>'team' = 'platform'

Nicht getaggte Kosten und Kosten, denen der Tag team fehlt:

Code
tags.name = NULL OR (costs.category = 'Compute' AND tags->>'team' = NULL)

Kosten eines eigenen Anbieters, benannt beim Anlegen:

Code
costs.provider = 'custom' AND costs.provider_name = 'Snowflake'

Compute-Kosten zweier Segmente, mit ihrem Anteil an den geteilten Kosten:

Code
costs.segment IN ('seg_...', 'seg_...') AND costs.category = 'Compute'

Kosten des Teams Team A, wie auch immer seine Tags es schreiben, in Konten, deren Name prod enthält:

Code
tags->>'team' ~* 'Team A' AND costs.account_name LIKE '%prod%'

Wie es sich verhält

  • OR wird zu Gruppen. Costfluent liest jede Verschachtelung von AND und OR als bis zu 10 Alternativen, jede eine mit AND verbundene Liste von Bedingungen: a AND (b OR c) wird zu (a AND b) OR (a AND c). Ein Filter enthält höchstens 20 Bedingungen in einer Alternative und 50 insgesamt. Ein Filter, der diese Grenzen überschreiten würde, wird mit einer Meldung abgelehnt, die die Grenze nennt.
  • Fehlende Werte. = NULL trifft eine Zeile, deren Feld leer ist, bei einem Tag eine Zeile ohne diesen Tag-Schlüssel. NULL wird nur mit = und != verglichen; costs.provider hat immer einen Wert, costs.tagged ist 'true' oder 'false' und costs.tag_compliance ist 'compliant' oder 'non_compliant', daher nimmt keines davon es an.
  • Anbieter. costs.provider nimmt Anbieterschlüssel und wird nur mit =, !=, IN und NOT IN verglichen. Ein Muster oder ein Wert, der kein Schlüssel ist, wird mit einer Meldung abgelehnt, die Beispielschlüssel nennt. Jeder eigene Anbieter hat den Schlüssel custom; unterscheiden Sie sie mit costs.provider_name, das wie jedes andere Feld Muster annimmt.
  • FOCUS-Werte. costs.charge_category und costs.pricing_category enthalten die oben aufgeführten Werte aus FOCUS 1.4, genau so geschrieben. Mit =, !=, IN oder NOT IN verglichen, wird jeder andere Wert, etwa OnDemand oder Spot, mit einer Meldung abgelehnt, die die Werte nennt; ein LIKE-Muster ist freier Text. On-Demand-Preise sind Standard, Spot-Preise Dynamic, Reservierungen und Savings Plans Committed, die costs.commitment_type unterscheidet.
  • Flexibler Vergleich. ~* entfernt Leerzeichen, Tabulatoren, Zeilenumbrüche, Bindestriche und Unterstriche aus dem Feld und aus jedem Wert und vergleicht sie ohne Rücksicht auf Groß- und Kleinschreibung, sodass tags->>'team' ~* 'Team A' auf Team A, team-a, team_a und TEAMA passt, aber nicht auf team-ab. !~* behält jede andere Zeile, auch die ohne das Feld oder den Tag-Schlüssel. Ein Wert nur aus den übergangenen Zeichen, etwa '-', wird abgelehnt. costs.provider, costs.tagged, costs.tag_compliance und costs.segment nehmen weder ~* noch !~* an.
  • Abrechnungszeitraum. costs.billing_period nimmt Monate in der Schreibweise YYYY-MM an, etwa '2026-03', verglichen nur mit =, !=, IN und NOT IN. Jede Zeile hat einen, daher nimmt das Feld kein NULL an, und ein Muster, ~* oder ein Wert, der kein solcher Monat ist, wird mit einer Meldung abgelehnt, die das sagt. Der Monat wird in UTC gelesen; Google Cloud gibt seinen Rechnungsmonat als Mitternacht pazifischer Zeit an, die in UTC noch in denselben Monat fällt.
  • Grenzen. Der Text ist auf 100.000 Zeichen und 32 Klammerebenen begrenzt.
  • Segmente. costs.segment nimmt Segment-IDs nur mit = oder IN an, in einer Bedingung eines Filters ohne OR; mehrere Segmente wählen Sie mit IN. !=, NOT IN, LIKE, NULL, eine zweite Segment-Bedingung und OR an beliebiger Stelle im Filter werden abgelehnt, ebenso der Topf für geteilte Kosten, der selbst keine Kosten besitzt. Eine ID, die kein Segment des Workspace ist, auch ein gelöschtes Segment, wird als nicht gefunden beantwortet. Zuordnungsregeln, Regeln virtueller Tags und Einsparungsmessungen können das Feld nicht verwenden. Wie geteilte Kosten in ein Segment eingehen, steht unter Segmente und Zuordnungsregeln.
  • Tag-Compliance. costs.tag_compliance nimmt 'compliant' oder 'non_compliant' nur mit =, !=, IN und NOT IN an und wird beim Ausführen des Berichts gegen die Tag-Richtlinie des Workspace gelesen; eine geänderte Richtlinie ändert also, was ein bestehender Bericht zählt. In einem Workspace ohne Richtlinie ist jede Zeile 'compliant'. Zuordnungsregeln, Regeln virtueller Tags und Einsparungsmessungen können das Feld nicht verwenden.
  • Regeln virtueller Tags. Der Filter einer Regel kann kein OR verwenden, weil Regeln bereits Alternativen sind, die der Reihe nach geprüft werden. Schreiben Sie jede Alternative als eigene Regel mit demselben Wert.
  • Kanonischer Text. Costfluent zeigt einen Filter in einer kanonischen Schreibweise: Feldnamen klein, Schlüsselwörter groß, einfache Abstände. Die Public API gibt beide Schreibweisen jedes Filters über GET /v1/cost-filters/translate zurück.
  • Kein Treffer. Ein Filter, dessen Werte auf nichts passen, zeigt das übliche leere Ergebnis des Berichts, keinen Fehler. Prüfen Sie Schreibweise sowie Groß- und Kleinschreibung der Werte anhand der Werte, die eine Filterbedingung auflistet.
  • Fehlermeldungen erscheinen in der Sprache der Oberfläche; die Public API antwortet auf Englisch.
  • Nicht unterstützt, mit einer Fehlermeldung, die das sagt:
    • costs.allocation und costs.marketplace, für die Costfluent keine Spalte hat
    • costs.charge_type: schreiben Sie costs.charge_category
    • tags.name und tags.value mit einem Wert: schreiben Sie tags->>'key' = 'value'

Verwandte Seiten