Overvåk en Cosmos DB-konto i Database Hub (forhåndsvisning)

Database Hub i Microsoft Fabric hjelper deg med å oppdage Azure Cosmos DB-kontoer på tvers av API-er (NoSQL, MongoDB, Cassandra, Gremlin, Table).

- 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.

Overvåk Cosmos DB på plass

Dine Cosmos DB-kontoer forblir Azure-ressurser i sine eksisterende abonnementer, ressursgrupper og regioner. Å bruke Database Hub for oppdagelse og overvåking krever ikke at du flytter data inn i Fabric, konfigurerer speiling eller onboarding til Cosmos DB Fleet Analytics.

Database Hub-metrikker beskriver kontoen med mindre en metrikk eller filterparameter eksplisitt identifiserer et smalere omfang, som en spesifikk database eller container.

• Cosmos DB-overvåking i Database Hub bruker eksisterende Azure Monitor-plattformmetrikker, som samles inn automatisk for hver konto uten eksplisitt konfigurasjon.
• Du trenger ikke aktivere diagnostiske (ressurs-)logger eller være integrert i Cosmos DB Fleet Analytics.
• Azure Monitor og Fleet Analytics er separate, frivillige verktøy for dypere undersøkelser, og de er ikke nødvendige for å fylle ut baseline-metrikker.

Forutsetninger

• I den nåværende forhåndsvisningen, be en Fabric-administrator om å velge din leietaker inn i forhåndsvisningsopplevelsen for Database Hub i Fabric-administrasjonsportalen. I Leietakerinnstillinger, aktiver Brukere kan få tilgang til databasehuben (forhåndsvisning).

• Start med den gratis opplevelsen ved å logge inn med jobb- eller skolekontoen din. Du kan gå inn via Azure-portalen eller direkte fra Microsoft Fabric, selv om du ikke har brukt Fabric før. Autentiser deg med en Microsoft Entra-identitet som har tilgang til Azure-abonnementene og Cosmos DB-ressursene du ønsker å jobbe med. Azure resource visibility alene gir ikke tillatelse til å søke i en database. Database Hub bruker din eksisterende Microsoft Entra ID og Azure RBAC-tillatelser i stedet for en separat tillatelsesmodell, så tilgangen du tildeler her følger standard Azure-rolletildelingstrinn.

  • For å oppdage og overvåke Cosmos DB-kontoer, tildel Leser-rollen , eller en rolle med større tillatelser, på abonnementsnivå for hvert abonnement som inneholder kontoer du ønsker å overvåke.
  • For å opprette en ny Cosmos DB-konto fra Database Hub, tildel rollen Cosmos DB Operator, eller en rolle med større tillatelser, i ressursgruppens omfang der kontoen skal opprettes.
  • Administrasjon eller omkonfigurering av en eksisterende konto, som å endre gjennomstrømning, indeksering eller nettverksinnstillinger, gjøres utenfor Database Hub, ved bruk av Azure-portalen, Azure CLI, Azure PowerShell eller en Azure Resource Manager-mal. Den samme identiteten krever Cosmos DB Operator-rollen, eller en rolle med større tillatelser, på kontoområdet for å gjøre disse endringene der.

• For å spørre data i en database eller container trenger identiteten din en egen Cosmos DB dataplan-rolletildeling (eller kontonøkler, der det er tillatt), pluss nettverkstilgang til kontoen. Tilgang på ressursnivå (management-plane) gir ikke denne tillatelsen. For å lære mer, se Connect using role-based access control og Microsoft Entra ID for Azure Cosmos DB.

• Database Hub respekterer dine eksisterende tilgangsgrenser. Database Hub gir ikke ekstra tilgang. Din innsikt i databaser er begrenset til ressurser din nåværende identitet er autorisert til å se. Å dele en visning eller sende noen en ressurslenke gir dem ikke tilgang til den underliggende serveren.

Se ditt Cosmos DB-bo

Bruk Database Hub for å identifisere ressurser som trenger undersøkelse. Fortsett i Azure-portalen eller Visual Studio Code for kontokonfigurasjon, arbeid på containernivå eller spørringsdiagnostikk.

1. Gå til Database Hub i Microsoft Fabric. I databaser-navigasjonen, velg Oversikt.
2. Seksjonen Hva trenger oppmerksomhet? peker på deler av databaseporteføljen din som trenger oppmerksomhet. Hvert kort og lenke i Hva trenger oppmerksomhet? fører til Dødsbo. I Eiendomsvisningen , under hver ressurs, vises Issues i fargerike brikker, mens Forslag vises i brikker med et lyspæreikon.
3. Filter the inventory to View: Azure Cosmos DB. Velg de relevante abonnementene eller ressursgruppene ved å bruke tilgjengelige filtre.
4. Søk etter kontoen du trenger, eller gå gjennom det filtrerte lageret. Velg kontoen for å se ressursdetaljene. Behandle denne kontoen som Azure-kontoens ressurs, ikke som en individuell database eller container.

Cosmos DB-overvåkingsmålinger i Database Hub

Oversikt viser tilgjengelighet og normaliserte RU-forbruksoppsummeringer på tvers av ressursene i din Cosmos DB-konto.

For en godt tilberedt, aktivt brukt konto, er det normalt å se begge linjene ligge på eller nær 100% mesteparten av tiden. Høyt RU-forbruk betyr at kontoen bruker mesteparten eller hele sin tilrettelagte gjennomstrømning. Om det er greit avhenger av tilgjengelighet i samme vindu.

• Høy tilgjengelighet samtidig betyr at forespørsler fortsatt lykkes, og kontoen utnytter det som er provisionert fullt ut.
• Et fall i tilgjengelighet på samme tid peker på reelle throtted eller mislykkede forespørsler, siden vedvarende maksimalt RU-forbruk er den samme tilstanden som utløser hastighetsbegrensning.

Følg nøye med når tilgjengeligheten faller merkbart under 100%. Vær også oppmerksom på at RU-forbruket forblir lavt over lengre tid, noe som kan peke på overprovisjonert gjennomstrømning.

Performance gir deg et nærmere blikk på spesifikke kontoer du eksplisitt har valgt. Den inkluderer ikke automatisk alle kontoene i Estate, og hvis ingen filtre brukes, begrenser ytelsesdiagrammet visningen til de første 100 ressursene for å holde siden responsiv. Før du behandler et ytelsesdiagram som eiendomsdekkende, bekreft hvilke kontoer som for øyeblikket er valgt, siden det begrensede utvalget og hele bobeholdningen kan variere.

Manglende telemetri er ikke null utnyttelse eller bevis på at en konto er frisk. Sjekk om kontoen produserte data i det valgte intervallet, og om en metrikk gjelder for API-typen og konfigurasjonen.

Tolk Cosmos DB-ytelsessignaler

Diagrammene på denne siden bruker et timetidskorn: en 24-timers visning plotter 24 punkter, ved å bruke tilhørende aggregering. Rutenettet bruker et annet tidskorn og reduserer hele det valgte området til én verdi per konto per kolonne i stedet for å plotte punkter over tid. For eksempel er nettets Peak Norm RU % det maksimale som observeres hvor som helst i det området, ikke en time-fordeling.

For mer informasjon, se Overvåk Azure Cosmos DB og støttede målinger for Microsoft. DocumentDB/databaseAccounts.

Tolk sikkerhets- og kapasitetsforskjeller i Cosmos DB

Database Hubs sikkerhetsside evaluerer tre Cosmos DB-signaler:

• Microsoft Entra ID-autentisering: om en konto håndhever Entra ID-only autentisering eller fortsatt tillater lokal (nøkkelbasert) autentisering.
• Kundestyrte nøkler (CMK): om CMK-kryptering er aktivert, eller om kontoen er avhengig av tjenesteadministrerte nøkler.
• Offentlig nettverkstilgang: om en konto har det aktivert.

Hvis en konto tillater lokal autentisering eller ikke har CMK aktivert, lister Database Hub det som et forslag, en valgfri forbedring du kan gjøre når det passer. En konto med offentlig nettverkstilgang aktivert er oppført som et Problem, siden det regnes som mer tidssensitivt.

Et Database Hub-signal gjenspeiler hva det for øyeblikket evaluerer, ikke nødvendigvis hele tilstanden til en kontos underliggende sikkerhetskonfigurasjon. For eksempel har en konto uten CMK aktivert fortsatt kryptering i hvile som standard via Microsoft-administrerte nøkler, så et flagg her betyr «ikke aktivert for denne spesifikke funksjonen» i stedet for «ubeskyttet». Verifiser kontoens nåværende konfigurasjon i Azure-portalen før du handler på et funn. Se Configure customer-managed keys for Azure Cosmos DB og Encryption at rest in Azure Cosmos DB for detaljer.

Disse sikkerhetssignalene gir deg en rask oversikt for å hjelpe deg med triage. For en fullstendig sikkerhetsvurdering og utbedring, bruk tjenester som Microsoft Defender for skyen og kontoens diagnostiske logger sammen med Database Hub.

Fortsett undersøkelsen i Azure-portalen

Du kan bruke Azure-portalen for å undersøke eventuelle problemer nærmere, for eksempel å sammenligne samme kontos måleparametere side om side i Database Hub og Azure-portalen.

1. Velg den tiltenkte Cosmos DB-kontoen i Database Hub. Et panel for det elementet åpnes i Database Hub.
2. Velg knappen Åpne Azure-portalen.
3. Gå til fanen Innsikt og sett tidsintervallet. Sammenlign de relevante måleparametrene over et passende oppfølgingsintervall.

Under den nåværende forhåndsvisningen tilbyr Azure-portalens Insights-fane et bredere utvalg av diagrammer og måleparametere, så bruk den for signaler Database Hub ennå ikke har dukket opp.

Undersøk sikkerhetsfunn i Cosmos DB

1. Velg Cosmos DB-funnet fra sikkerhetsoppsummeringen eller den berørte kontoen i Estate, der det er tilgjengelig.

2. Bekreft den berørte kontoen, vurderingsnavn, evaluert setting og eventuell tilgjengelig observasjonstid. Sjekk anbefalingen opp mot organisasjonens retningslinjer.

3. Åpne kontoen i Azure-portalen og verifiser dens nåværende konfigurasjon. For Microsoft Entra-autentisering, kundeadministrerte nøkler eller offentlig nettverkstilgang, følg den tilsvarende Cosmos DB-tjenestedokumentasjonen.

4. Vurder applikasjonens påvirkning og innhent nødvendig godkjenning før du gjør en endring.

5. Etter at den autoriserte endringen er fullført, verifiser innstillingen i Azure-portalen. Tillat revurdering og oppdatering av Database Hub; hvis funnet vedvarer, sammenlign bevisene med kontokonfigurasjonen.

Feilsøk Cosmos DB-data i Database Hub

• Hvis en Cosmos DB-konto ikke vises i Estate, sjekk innlogget leietaker, Azure-tilgang, ressurstype, inventarfiltre og autorisasjon.
• Hvis ytelsesmålinger mangler eller er forskjellige mellom Azure Monitor og Database Hub:
  • Velg et tidsintervall hvor kontoen aktivt betjente forespørsler. Sjekk om metrikken gjelder for kontoens API-type; for eksempel varierer 429-kartleggingen mellom NoSQL (StatusCode 429) og MongoDB API (feilkode 16500).
  • Åpne samme konto i Azure-portalen og inspiser den tilsvarende Azure Monitor-metrikken under fanen Insights. Samsvar tidssone, start- og slutttider, aggregering og granularitet så tett som mulig.
  • Hvis målingen mangler begge steder, sjekk kontoaktiviteten og tilregn behandlingsforsinkelse.
  • Hvis Azure Monitor har data, men ikke Database Hub, oppdater du Database Hub-visningen og prøver på nytt med den kontoen alene. Hvis forskjellen vedvarer, kontakt Support.

Begrensninger

• Cosmos DB Fleet Analytics støttes for øyeblikket ikke i Database Hub.
• Den nåværende forhåndsvisningen støtter kun Azure Cosmos DB-kontoer. I den nåværende forhåndsvisningen støttes ikke Cosmos DB in Fabric for øyeblikket.
• I den nåværende forhåndsvisningen viser Overview og Performance et kuratert delsett av metrikkene som er tilgjengelige i Azure Monitor.
• I den nåværende forhåndsvisningen er ikke Activator tilgjengelig for varsling over Cosmos DB-målinger.

Relatert innhold

• Overvåke Azure Cosmos DB
• Støttede måleparametere for Microsoft. DocumentDB/database Kontoer
• Koble til ved hjelp av rollebasert tilgangskontroll og Microsoft Entra ID for Azure Cosmos DB
• Fleet Analytics for Azure Cosmos DB
• Visual Studio Code extension for Azure Cosmos DB