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
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,gcpoderkubernetes, demselben Schlüssel, den die Public API zurückgibt. Der Name des Anbieters, etwaAmazon Web Services, ist ein eigenes Feld,costs.provider_name.
Einen Filter in einem Bericht schreiben
- Öffnen Sie einen Bericht unter Kostenberichte und wählen Sie Als Text bearbeiten neben Filter hinzufügen, über dem Diagramm.
- 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.
- 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
| CQL | Filterfeld |
|---|---|
costs.provider | Anbieter |
costs.provider_name | Anbietername |
costs.account_id | Unterkonto |
costs.account_name | Name des Unterkontos: der Name, den die Rechnung dem Konto gibt |
costs.service | Dienst |
costs.region | Region |
costs.resource_name | Ressource |
costs.resource_group | Ressourcengruppe: die Azure-Ressourcengruppe, gelesen aus der Ressourcen-ID |
costs.charge_category | Kostenkategorie: Usage, Purchase, Tax, Credit oder Adjustment |
costs.cluster | Cluster |
costs.namespace | Namespace |
costs.provider_account_id | Abrechnungskonto |
costs.provider_account_name | Name des Abrechnungskontos: der Name, den die Rechnung dem Konto gibt, nie der Name einer Verbindung, den ein Bericht neben seiner ID zeigen kann |
costs.category | Dienstkategorie |
costs.subcategory | Dienstunterkategorie |
costs.usage_unit | Nutzungseinheit |
costs.charge_class | Kostenklasse: Correction für eine Gebühr, die einen früheren Zeitraum korrigiert |
costs.resource_id | Ressourcen-ID |
costs.commitment_status | Commitment-Status: Used oder Unused |
costs.commitment_type | Commitment-Typ: SavingsPlan, ReservedInstance oder CommittedUseDiscount |
costs.commitment_id | Commitment: die ID des Anbieters dafür, etwa die ARN eines Savings Plans |
costs.pricing_category | Preiskategorie: Standard, Dynamic, Committed oder Other, bei einer Steuer keine |
costs.sku | SKU: die Bezeichnung des Anbieters für das Abgerechnete, oder die SKU-ID einer Zeile ohne Bezeichnung |
costs.sku_id | SKU-ID: die ID des Anbieters für das Abgerechnete |
costs.operation | Vorgang: der abgerechnete AWS-Vorgang, etwa RunInstances |
costs.charge_description | Kostenbeschreibung: der Text, den die Rechnung selbst für die Zeile führt |
costs.resource_type | Ressourcentyp: die Art der abgerechneten Ressource, wie der Anbieter sie nennt |
costs.product_family | Produktfamilie: die Dienstfamilie von Azure, etwa Compute |
costs.invoice_id | Rechnungs-ID: die Rechnung des Anbieters, auf der die Zeile abgerechnet wird |
costs.invoice_issuer | Rechnungssteller: die juristische Person des Anbieters, die die Zeile in Rechnung stellt, etwa Amazon Web Services EMEA SARL |
costs.billing_period | Abrechnungszeitraum: der abgerechnete Monat, geschrieben YYYY-MM, etwa '2026-03' |
costs.tagged | Getaggt: '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_compliance | Tag-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.segment | Segment, benannt durch seine ID (seg_...): die Kosten, die Ihre Zuordnungsregeln dem Segment zuordnen, plus sein Anteil an den geteilten Kosten |
Operatoren
| Schreibweise | Bedeutung |
|---|---|
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 != NULL | hat keinen Wert / hat einen Wert |
tags.name = NULL / tags.name != NULL | nicht 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
Kosten mit Produktions-Tag oder alles in einem Kubernetes-Namespace, der mit payments beginnt:
Code
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
Nicht getaggte Kosten und Kosten, denen der Tag team fehlt:
Code
Kosten eines eigenen Anbieters, benannt beim Anlegen:
Code
Compute-Kosten zweier Segmente, mit ihrem Anteil an den geteilten Kosten:
Code
Kosten des Teams Team A, wie auch immer seine Tags es schreiben, in Konten, deren Name prod enthält:
Code
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.
= NULLtrifft eine Zeile, deren Feld leer ist, bei einem Tag eine Zeile ohne diesen Tag-Schlüssel.NULLwird nur mit=und!=verglichen;costs.providerhat immer einen Wert,costs.taggedist'true'oder'false'undcosts.tag_complianceist'compliant'oder'non_compliant', daher nimmt keines davon es an. - Anbieter.
costs.providernimmt Anbieterschlüssel und wird nur mit=,!=,INundNOT INverglichen. 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üsselcustom; unterscheiden Sie sie mitcosts.provider_name, das wie jedes andere Feld Muster annimmt. - FOCUS-Werte.
costs.charge_categoryundcosts.pricing_categoryenthalten die oben aufgeführten Werte aus FOCUS 1.4, genau so geschrieben. Mit=,!=,INoderNOT INverglichen, wird jeder andere Wert, etwaOnDemandoderSpot, mit einer Meldung abgelehnt, die die Werte nennt; einLIKE-Muster ist freier Text. On-Demand-Preise sindStandard, Spot-PreiseDynamic, Reservierungen und Savings PlansCommitted, diecosts.commitment_typeunterscheidet. - 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, sodasstags->>'team' ~* 'Team A'aufTeam A,team-a,team_aundTEAMApasst, aber nicht aufteam-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_complianceundcosts.segmentnehmen weder~*noch!~*an. - Abrechnungszeitraum.
costs.billing_periodnimmt Monate in der SchreibweiseYYYY-MMan, etwa'2026-03', verglichen nur mit=,!=,INundNOT IN. Jede Zeile hat einen, daher nimmt das Feld keinNULLan, 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.segmentnimmt Segment-IDs nur mit=oderINan, in einer Bedingung eines Filters ohne OR; mehrere Segmente wählen Sie mitIN.!=,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_compliancenimmt'compliant'oder'non_compliant'nur mit=,!=,INundNOT INan 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/translatezurü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.allocationundcosts.marketplace, für die Costfluent keine Spalte hatcosts.charge_type: schreiben Siecosts.charge_categorytags.nameundtags.valuemit einem Wert: schreiben Sietags->>'key' = 'value'