Monitor een Cosmos DB-account in de Database Hub (preview)

Database Hub in Microsoft Fabric helpt je Azure Cosmos DB-accounts te ontdekken over API's heen (NoSQL, MongoDB, Cassandra, Gremlin, Table).

Tip

💡 Agent-setup voor Database Hub

Begin met het gebruik van de Database Hub-agentvaardigheden om de Database Hub in Fabric te begrijpen en ermee te communiceren:

- Use [Database Hub skills](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh).
- Review [Database Hub in Fabric documentation](https://learn.microsoft.com/fabric/database/hub/)
  and use the [Microsoft Learn MCP server](https://learn.microsoft.com/api/mcp) for official docs.

Important

Deze functie is beschikbaar als preview-versie.

Cosmos DB ter plaatse bewaken

Je Cosmos DB-accounts blijven Azure-bronnen in hun bestaande abonnementen, resourcegroepen en regio's. Het gebruik van Database Hub voor detectie en monitoring vereist niet dat gegevens naar Fabric worden verplaatst, spiegeling wordt geconfigureerd of onboarding op Cosmos DB Fleet Analytics plaatsvindt.

Database Hub-metrics beschrijven het account, tenzij een metriek of filterparameter expliciet een smallere scope aanduidt, zoals een specifieke database of container.

  • Cosmos DB-monitoring in Database Hub gebruikt bestaande Azure Monitor-platformmetrics, die automatisch worden verzameld voor elk account zonder expliciete configuratie.
  • Je hoeft geen diagnostische (resource) logs in te schakelen of onboard te zijn in Cosmos DB Fleet Analytics.
  • Azure Monitor en Fleet Analytics zijn aparte, opt-in tools voor diepgaand onderzoek en zijn niet nodig om basisstatistieken te vullen.

Prerequisites

  • Vraag in de huidige preview een Fabric-beheerder om je tenant op te melden voor de Database Hub-preview-ervaring in het Fabric-beheerportaal. In Tenant-instellingen schakel je Gebruikers in die toegang hebben tot de Databasehub (preview).

  • Begin met de gratis ervaring door in te logen met je werk- of schoolaccount. Je kunt het via het Azure-portaal of direct vanuit Microsoft Fabric invoeren, zelfs als je Fabric nog niet hebt gebruikt. Authenticeer met een Microsoft Entra-identiteit die toegang heeft tot de Azure-abonnementen en Cosmos DB-bronnen waarmee je wilt werken. Azure resource visibility alleen geeft geen toestemming om een database te bevragen. Database Hub gebruikt je bestaande Microsoft Entra ID- en Azure RBAC-rechten in plaats van een apart permissiemodel, dus de toegang die je hier toewijst volgt de standaard Azure-roltoewijzingstappen.

    • Om Cosmos DB-accounts te ontdekken en te monitoren, wijs je de rol Lezer toe, of een rol met meer rechten, bij het abonnementsbereik voor elk abonnement dat accounts bevat die je wilt monitoren.
    • Om een nieuw Cosmos DB-account aan te maken vanuit Database Hub, wijs je de rol Cosmos DB Operator, of een rol met meer rechten, toe aan de resourcegroepscope waar het account wordt aangemaakt.
    • Het beheren of herconfigureren van een bestaand account, zoals het wijzigen van doorvoer, indexering of netwerkinstellingen, gebeurt buiten Database Hub, met behulp van het Azure-portaal, Azure CLI, Azure PowerShell of een Azure Resource Manager-sjabloon. Dezelfde identiteit heeft de rol Cosmos DB Operator nodig, of een rol met meer rechten, op accountniveau om daar deze wijzigingen aan te brengen.

  • Voor het opvragen van data in een database of container heeft je identiteit een aparte Cosmos DB dataplane-roltoewijzing nodig (of accountsleutels, waar toegestaan), plus netwerktoegang tot het account. Toegang op resourceniveau (managementplane) verleent deze toestemming niet. Voor meer informatie, zie Connect met rolgebaseerde toegangscontrole en Microsoft Entra ID voor Azure Cosmos DB.

  • Database Hub respecteert je bestaande toegangsgrenzen. De Database Hub geeft geen extra toegang. Je zichtbaarheid in databases is beperkt tot bronnen die je huidige identiteit mag bekijken. Het delen van een view of het sturen van een resource link geeft geen toegang tot de onderliggende server.

Bekijk uw Cosmos DB-nalatenschap

Tip

De Cosmos DB-bron die in Estate wordt weergegeven is een databaseaccount, niet elke database of container die binnen dat account wordt gehost.

Gebruik de Database Hub om bronnen te identificeren die onderzocht moeten worden. Ga verder in het Azure-portaal of Visual Studio Code voor accountconfiguratie, werk op containerniveau of querydiagnostiek.

  1. Ga naar de databasehub in Microsoft Fabric. Selecteer in de Databases-navigatie Overzicht.
  2. De sectie Wat moet aandacht verdienen? wijst op delen van je database-estate die aandacht nodig hebben. Elke kaart en link in Wat heeft aandacht nodig? leidt naar Estate. In de Estate-weergave verschijnen onder elke bron Issues in kleurrijke chips, terwijl Suggestions verschijnen in chips met een lampjes-icoon.
  3. Filter de inventaris naar View: Azure Cosmos DB. Selecteer de relevante abonnementen of resourcegroepen met behulp van de beschikbare filters.
  4. Zoek naar het account dat je nodig hebt, of bekijk de gefilterde voorraad. Selecteer het account om de brongegevens te bekijken. Behandel dit account als de Azure-accountbron, niet als een individuele database of container.

Cosmos DB-bewakingsmetriek in de Database Hub

Overzicht toont samenvattingen van de beschikbaarheid en het genormaliseerde RU-verbruik voor de resources in uw Cosmos DB-account.

Voor een goed ingesteld, actief gebruikt account is het normaal dat beide lijnen meestal op of rond 100% staan. Hoog RU-verbruik betekent dat de rekening het grootste deel of de volledige gereserveerde doorvoer gebruikt. Of dat goed is, hangt af van beschikbaarheid in hetzelfde tijdsvenster.

  • Hoge beschikbaarheid betekent dat verzoeken nog steeds slagen en het account gewoon volledig gebruik maakt van wat beschikbaar is.
  • Een daling in beschikbaarheid op hetzelfde moment wijst op echte gesmoorde of mislukte verzoeken, aangezien aanhoudend maximaal RU-verbruik dezelfde conditie is die snelheidsbeperking activeert.

Let goed op wanneer de beschikbaarheid merkbaar onder de 100%daalt. Let ook op RU-verbruik dat gedurende langere tijd laag blijft, wat kan wijzen op een te hoog geconfigureerde doorvoer.

Performance geeft je een beter beeld van specifieke accounts die je expliciet selecteert. Het bevat niet automatisch elk account in Estate, en als er geen filters worden toegepast, beperkt de prestatiegrafiek het zicht tot de eerste 100 bronnen om de pagina responsief te houden. Voordat je een Performance-grafiek als estatebreed beschouwt, moet je controleren welke accounts momenteel zijn geselecteerd, aangezien de afgebakende selectie en je volledige Estate-inventaris kunnen verschillen.

Het missen van telemetrie is geen nulbenutting of bewijs dat een account gezond is. Controleer of het account gegevens heeft geproduceerd tijdens het geselecteerde interval en of een metriek van toepassing is op het API-type en de configuratie.

Interpreteer Cosmos DB-prestatiesignalen

Signaal Azure Monitor-metriek Aggregatie Description
Genormaliseerd RU-verbruik (Pieknorm RU %) NormalizedRUConsumption Maximum Maximale RU/s-benutting over partitiesleutelbereiken van het account, 0 tot 100%.
Totaal aantal aanvraageenheden (totaal verbruikte RU) TotalRequestUnits Het totaal (som) Totaal aantal verbruikte RU’s, opgesomd over het geselecteerde interval.
Beperkte verzoeken (429s) TotalRequests gefilterd naar StatusCode 429 Count Ruw aantal verzoeken dat is geweigerd omdat ze de ingerichte doorvoercapaciteit overschrijden.
429 Tarief % TotalRequests gefilterd naar StatusCode 429, gedeeld door het totaal aantal TotalRequests Aantal (ratio) Percentage van de verzoeken dat wordt beperkt omdat de ingerichte doorvoercapaciteit wordt overschreden.
Geprovisioneerde doorvoer (Provisioned RU/s) ProvisionedThroughput Maximum De voor het account ingerichte RU/s over het geselecteerde interval, zodat je de ingerichte en verbruikte capaciteit kunt vergelijken.
Gemiddelde latentie (ms) ServerSideLatencyDirect Average Gemiddelde server-side latentie in milliseconden voor verzoeken die in directe verbindingsmodus worden gedaan. Gateway-modus latentie is niet inbegrepen.
Beschikbaarheid % ServiceAvailability Average Percentage verzoeken dat tijdens de pauze succesvol was.

Opmerking

Beschikbaarheid % voor Performance gebruikt de aggregatie Gemiddelde. De beschikbaarheidssamenvatting van de Overzichtspagina gebruikt in plaats daarvan Minimumaggregatie om uitschieters te markeren.

Grafieken op deze pagina gebruiken een uurtijdskorrel: een 24-uurs weergave plott 24 punten, met behulp van de bijbehorende aggregatie. Het raster gebruikt een andere tijdskorrel en reduceert je volledige geselecteerde bereik tot één waarde per account per kolom in plaats van punten over tijd uit te zetten. Zo is de Peak Norm RU % van het grid het maximum dat ergens in dat bereik wordt waargenomen, niet een uitsplitsing per uur.

Voor meer informatie, zie Monitor Azure Cosmos DB en Ondersteunde metrics voor Microsoft. DocumentDB/databaseAccounts.

Interpreteer de verschillen in beveiliging en mogelijkheden van Cosmos DB

De beveiligingspagina van de Database Hub evalueert drie Cosmos DB-signalen:

  • Microsoft Entra ID-authenticatie: of een account Entra ID-only authenticatie afdwingt of nog steeds lokale (sleutelgebaseerde) authenticatie toestaat.
  • Klantbeheerde sleutels (CMK): of CMK-encryptie is ingeschakeld, of of het account afhankelijk is van servicebeheerde sleutels.
  • Toegang tot het publieke netwerk: of een account het heeft ingeschakeld.

Als een account lokale authenticatie toestaat of CMK niet heeft ingeschakeld, vermeldt Database Hub dit als een Suggestie, een optionele verbetering die je kunt maken wanneer het uitkomt. Een account met publieke netwerktoegang ingeschakeld wordt als een Probleem vermeld, omdat dat als tijdgevoeliger wordt beschouwd.

Een Database Hub-signaal weerspiegelt wat het momenteel evalueert, niet noodzakelijk de volledige staat van de onderliggende beveiligingsconfiguratie van een account. Bijvoorbeeld, een account zonder CMK ingeschakeld heeft standaard nog steeds encryptie in rust via door Microsoft beheerde sleutels, dus een vlag hier betekent "niet ingeschakeld voor deze specifieke functie" in plaats van "onbeschermd." Controleer de huidige configuratie van het account in het Azure-portaal voordat je een bevinding uitvoert. Zie Door de klant beheerde sleutels configureren voor Azure Cosmos DB en Versleuteling van data-at-rest in Azure Cosmos DB voor meer informatie.

Deze beveiligingssignalen bieden een snel overzicht om je te helpen bij de triage. Voor een volledige beveiligingsbeoordeling en -herstel gebruik je diensten zoals Microsoft Defender voor Cloud en de diagnostische logs van je account naast Database Hub.

Onderzoek voortzetten in het Azure-portaal

Je kunt het Azure-portaal gebruiken om eventuele problemen verder te onderzoeken, bijvoorbeeld om de metrics van hetzelfde account naast elkaar te vergelijken in Database Hub en het Azure-portaal.

Tip

Gebruik de Visual Studio Code Cosmos DB-extensie voor dataplane-werk zoals het queryen en beheren van documenten, maar niet voor het beoordelen van prestatie-indicatoren.

  1. Selecteer het beoogde Cosmos DB-account in Database Hub. Een paneel voor dat item opent in de Database Hub.
  2. Selecteer de knop Open het Azure-portaal.
  3. Ga naar het tabblad Inzichten en stel het tijdsbereik in. Vergelijk de relevante statistieken over een passend follow-up interval.

Tijdens de huidige preview biedt het tabblad Insights van het Azure-portaal een breder scala aan grafieken en metrics, dus gebruik het voor signalen die de Database Hub nog niet laat zien.

Onderzoek beveiligingsbevindingen van Cosmos DB

  1. Selecteer de Cosmos DB-vondst uit de Beveiligingssamenvatting of de getroffen rekening in Estate, waar beschikbaar.

  2. Bevestig het betrokken account, de naam van de beoordeling, de geëvalueerde instelling en eventuele beschikbare observatietijd. Controleer de aanbeveling met het beleid van je organisatie.

  3. Open het account in het Azure-portaal en verifieer de huidige configuratie. Voor Microsoft Entra-authenticatie, door klanten beheerde sleutels of publieke netwerktoegang volgt u de bijbehorende Cosmos DB-servicedocumentatie.

  4. Beoordeel de impact van de aanvraag en verkrijg de vereiste goedkeuring voordat u een wijziging aanbrengt.

  5. Nadat de geautoriseerde wijziging is voltooid, verifieer je de instelling in het Azure-portaal. Laat herbeoordeling toe en vernieuw de Database Hub; als de bevinding blijft bestaan, vergelijk dan het bewijs met de huidige rekeningconfiguratie.

Problemen met Cosmos DB-gegevens in Database Hub oplossen

  • Als een Cosmos DB-account niet in Estate verschijnt, controleer dan de ingelogde tenant, Azure-toegang, resourcetype, inventarisfilters en autorisatie.
  • Als prestatiemetrieken ontbreken of verschillen tussen Azure Monitor en Database Hub:
    • Kies een tijdsinterval waarin het account actief verzoeken afleverde. Controleer of de metriek van toepassing is op het API-type van het account; bijvoorbeeld, de 429-mapping verschilt tussen NoSQL (StatusCode 429) en MongoDB API (foutcode 16500).
    • Open hetzelfde account in het Azure-portaal en bekijk de bijbehorende Azure Monitor-metriek onder het tabblad Insights. Stem de tijdzone, begin- en eindtijden, aggregatie en granulariteit zo nauwkeurig mogelijk af.
    • Als de metric op beide plaatsen ontbreekt, controleer dan de accountactiviteit en houd rekening met verwerkingsvertraging.
    • Als Azure Monitor data heeft maar Database Hub niet, ververs dan de Database Hub-weergave en probeer het opnieuw met dat account alleen. Als het verschil aanhoudt, neem dan contact op met de Support.

Limitations

  • Cosmos DB Fleet Analytics wordt momenteel niet ondersteund in Database Hub.
  • De huidige preview ondersteunt alleen Azure Cosmos DB-accounts. In de huidige preview wordt Cosmos DB in Fabric momenteel niet ondersteund.
  • In de huidige preview tonen Overzicht en Prestaties een samengestelde subset van de metrieken die beschikbaar zijn in Azure Monitor.
  • In de huidige preview zijn waarschuwingen van Activator voor Cosmos DB-metrieken niet beschikbaar.

Verwante onderwerpen

  • Laatst bijgewerkt om