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

Database Hub i Microsoft Fabric hjælper dig med at opdage Azure Cosmos DB-konti på tværs af API'er (NoSQL, MongoDB, Cassandra, Gremlin, Table).

Tip

💡 Agentopsætning til Database Hub

Kom i gang med at bruge Database Hub-agentfærdigheder til at forstå og interagere med Database Hub in Fabric:

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

Vigtig

Denne funktion er i prøveversion.

Overvåg Cosmos DB på plads

Dine Cosmos DB-konti forbliver Azure-ressourcer i deres eksisterende abonnementer, ressourcegrupper og regioner. Brug af Database Hub til opdagelse og overvågning kræver ikke, at data flyttes ind i Fabric, konfigureres spejling eller onboardings til Cosmos DB Fleet Analytics.

Database Hub-metrikker beskriver kontoen, medmindre en metrik eller filterparameter eksplicit identificerer et smallere omfang, såsom en specifik database eller container.

  • Cosmos DB-overvågning i Database Hub bruger eksisterende Azure Monitor-platformmetrikker, som indsamles automatisk for hver konto uden eksplicit konfiguration.
  • Du behøver ikke aktivere diagnostiske (ressource-) logfiler eller være onboard til Cosmos DB Fleet Analytics.
  • Azure Monitor og Fleet Analytics er separate, opt-in værktøjer til dybere undersøgelse, og de er ikke nødvendige for at udfylde baseline-metrikker.

Forudsætninger

  • I den nuværende forhåndsvisning kan du bede en Fabric-administrator om at tilmelde din lejer i Database Hub-forhåndsvisningsoplevelsen i Fabric-administrationsportalen. I Lejerindstillinger aktiveres Brugere kan få adgang til databasehubben (forhåndsvisning).

  • Start med den gratis oplevelse ved at logge ind med din arbejds- eller skolekonto. Du kan indtaste via Azure-portalen eller direkte fra Microsoft Fabric, selvom du ikke har brugt Fabric før. Autentificér med en Microsoft Entra-identitet, der har adgang til de Azure-abonnementer og Cosmos DB-ressourcer, du ønsker at arbejde med. Azure resource visibility alene giver ikke tilladelse til at forespørge en database. Database Hub bruger din eksisterende Microsoft Entra ID og Azure RBAC-tilladelser i stedet for en separat tilladelsesmodel, så den adgang, du tildeler her, følger standard Azure-rollefordelingstrin.

    • For at opdage og overvåge Cosmos DB-konti, tildel læserrollen eller en rolle med større rettigheder i abonnementsomfanget for hvert abonnement, der indeholder konti, du ønsker at overvåge.
    • For at oprette en ny Cosmos DB-konto fra Database Hub, tildeles rollen som Cosmos DB Operator, eller en rolle med større rettigheder, i ressourcegruppens scope, hvor kontoen skal oprettes.
    • Håndtering eller omkonfiguration af en eksisterende konto, såsom ændring af gennemstrømning, indeksering eller netværksindstillinger, sker uden for Database Hub, ved brug af Azure-portalen, Azure CLI, Azure PowerShell eller en Azure Resource Manager-skabelon. Den samme identitet kræver Cosmos DB Operator-rollen, eller en rolle med større rettigheder, i kontoens omfang for at foretage disse ændringer der.

  • For at forespørge data i en database eller container kræver din identitet en separat Cosmos DB dataplane-rolletildeling (eller kontonøgler, hvor det er tilladt), plus netværksadgang til kontoen. Adgang på ressourceniveau (management-plane) giver ikke denne tilladelse. For at lære mere, se Connect using role-based access control og Microsoft Entra ID for Azure Cosmos DB.

  • Database Hub respekterer dine eksisterende adgangsgrænser. Database Hub giver ikke yderligere adgang. Din synlighed i databaser er begrænset til ressourcer, som din nuværende identitet har tilladelse til at vise. At dele en visning eller sende nogen et ressourcelink giver dem ikke adgang til den underliggende server.

Se din Cosmos DB-ejendom

Tip

Cosmos DB-ressourcen, der er repræsenteret i Estate , er en databasekonto, ikke hver database eller container, der er hostet i den konto.

Brug Database Hub til at identificere ressourcer, der kræver undersøgelse. Fortsæt i Azure-portalen eller Visual Studio Code for kontokonfiguration, container-niveau arbejde eller forespørgselsdiagnostik.

  1. Gå til Database Hub i Microsoft Fabric. I databaser-navigationen skal du vælge Oversigt.
  2. Afsnittet Hvad kræver opmærksomhed? peger på dele af din database, der kræver opmærksomhed. Hvert kort og link i Hvad skal have opmærksomhed? fører til Dødsbo. I Ejendomsvisningen vises Issues under hver ressource i farverige chips, mens Forslag vises i chips med et pære-ikon.
  3. Filtrer inventaret til View: Azure Cosmos DB. Vælg de relevante abonnementer eller ressourcegrupper ved at bruge de tilgængelige filtre.
  4. Søg efter den konto, du har brug for, eller gennemgå det filtrerede lager. Vælg kontoen for at gennemgå dens ressourceoplysninger. Behandl denne konto som Azure-kontoens ressource, ikke som en individuel database eller container.

Cosmos DB overvågningsmålinger i Database Hub

Oversigt viser tilgængelighed og normaliserede RU-forbrugsopsummeringer på tværs af dine Cosmos DB-kontoressourcer.

For en velprovisioneret, aktivt brugt konto er det normalt at se begge linjer ligge på eller nær 100% det meste af tiden. Højt RU-forbrug betyder, at kontoen bruger det meste eller hele sin provisionerede gennemstrømning. Om det er i orden, afhænger af tilgængeligheden i samme vindue.

  • Høj tilgængelighed samtidig betyder, at anmodninger stadig lykkes, og kontoen udnytter det fuldt ud, hvad der er provisioneret.
  • Et fald i tilgængelighed på samme tid peger på reelle hæpnede eller mislykkede forespørgsler, da vedvarende maksimalt RU-forbrug er den samme tilstand, der udløser hastighedsbegrænsning.

Vær mere opmærksom, når tilgængeligheden falder mærkbart under 100%. Hold også øje med, at RU-forbruget forbliver lavt over en længere periode, hvilket kan pege på overprovisioneret gennemstrømning.

Performance giver dig et nærmere kig på specifikke konti, du eksplicit vælger. Den inkluderer ikke automatisk alle konti i Estate, og hvis der ikke anvendes filtre, begrænser Performance-diagrammet visningen til de første 100 ressourcer for at holde siden responsiv. Før du behandler et performance-diagram som ejendomsdækkende, skal du bekræfte, hvilke konti der aktuelt er valgt, da det scoped-udvalg og dit fulde bo-inventar kan variere.

Manglende telemetri er ikke nul udnyttelse eller bevis på, at en konto er sund. Tjek om kontoen har produceret data i det valgte interval, og om en metrik gælder for dens API-type og konfiguration.

Fortolk Cosmos DB-ydelsessignaler

Signal Azure Monitor metric Aggregering Beskrivelse
Normaliseret RU-forbrug (Peak Norm RU %) NormalizedRUConsumption Maksimum Maksimal RU/s-udnyttelse på tværs af partitionnøgleområder for kontoen, 0 til 100%.
Samlede anmodningsenheder (Totalt forbrugt RU) TotalRequestUnits Total (Sum) Samlede forbrugte RU'er, summeret over det valgte interval.
Hæpne forespørgsler (429'ere) TotalRequests filtreret til Statuskode 429 Tælling Rå optælling af anmodninger afvist for overskridelse af provisioneret gennemstrømning.
429 Rate % TotalRequests filtreret til StatusCode 429, divideret med det samlede antal TotalRequests Antal (forhold) Procentdelen af forespørgslerne er begrænset for at overskride provisioneret gennemstrømning.
Promitteret gennemstrømning (Provisionerede RU/s) ProvisionedThroughput Maksimum RU/s blev provisioneret for kontoen over det valgte interval, så du kan sammenligne provisioneret og forbrugt kapacitet.
Gennemsnitlig latenstid (ms) ServerSideLatencyDirect Gennemsnit Gennemsnitlig server-side latenstid i millisekunder for anmodninger i direkte forbindelsestilstand. Inkluderer ikke gateway-mode latens.
Tilgængelighed i % ServiceAvailability Gennemsnit Procentdel af anmodninger, der lykkedes i pausen.

Bemærkning

Tilgængelighed % på Performance bruger Average aggregation. Oversigtssidens tilgængelighedsoversigt bruger i stedet Minimum aggregation til at fremhæve outliers.

Diagrammerne på denne side bruger et time-tidskorn: en 24-timers visning viser 24 punkter ved hjælp af den tilhørende aggregering. Gitteret bruger et andet tidskorn og reducerer hele dit valgte interval til én værdi pr. konto pr. kolonne i stedet for at plotte punkter over tid. For eksempel er gitterets Peak Norm RU % det maksimum, der observeres i dette interval, ikke en time-opdeling.

For mere information, se Overvåg Azure Cosmos DB og Understøttede målinger for Microsoft. DocumentDB/databaseAccounts.

Fortolk Cosmos DB-sikkerheds- og kapacitetsforskelle

Database Hub'ens sikkerhedsside evaluerer tre Cosmos DB-signaler:

  • Microsoft Entra ID-autentificering: om en konto håndhæver Entra ID-only autentificering eller stadig tillader lokal (nøglebaseret) autentificering.
  • Kundeadministrerede nøgler (CMK): om CMK-kryptering er aktiveret, eller om kontoen er afhængig af serviceadministrerede nøgler.
  • Offentlig netværksadgang: om en konto har det aktiveret.

Hvis en konto tillader lokal autentificering eller ikke har CMK aktiveret, viser Database Hub det som et forslag, en valgfri forbedring, du kan lave, når det passer dig. En konto med offentlig netværksadgang aktiveret er opført som et problem, da det betragtes som mere tidsfølsomt.

Et Database Hub-signal afspejler, hvad det aktuelt evaluerer, ikke nødvendigvis den komplette tilstand af en kontos underliggende sikkerhedskonfiguration. For eksempel har en konto uden CMK aktiveret stadig kryptering i hvile som standard via Microsoft-administrerede nøgler, så et flag her betyder "ikke aktiveret for denne specifikke funktion" i stedet for "ubeskyttet." Verificér kontoens nuværende konfiguration i Azure-portalen, før du handler på en fund. Se Configure customer-managed keys for Azure Cosmos DB og Encryption at rest i Azure Cosmos DB for detaljer.

Disse sikkerhedssignaler giver dig et hurtigt overblik, der hjælper dig med at triagere. For en komplet sikkerhedsvurdering og udbedring kan du bruge tjenester som Microsoft Defender for Cloud og din kontos diagnostiske logfiler sammen med Database Hub.

Fortsæt undersøgelsen i Azure-portalen

Du kan bruge Azure-portalen til yderligere at undersøge eventuelle problemer, for eksempel for at sammenligne den samme kontos metrikker side om side i Database Hub og Azure-portalen.

Tip

Brug Visual Studio Code Cosmos DB-udvidelsen til dataplane-arbejde som forespørgsler og håndtering af dokumenter, men ikke til at gennemgå præstationsmålinger.

  1. Vælg den tiltænkte Cosmos DB-konto i Database Hub. Et panel for det element åbner i Database Hub.
  2. Vælg knappen 'Åbn Azure-portalen.
  3. Gå til fanen Insights og sæt tidsintervallet. Sammenlign de relevante målinger over et passende opfølgningsinterval.

Under den nuværende forhåndsvisning tilbyder Azure-portalens Insights-fane et bredere udvalg af diagrammer og målinger, så brug den til signaler, som Database Hub endnu ikke har vist.

Undersøg sikkerhedsfund i Cosmos DB

  1. Vælg Cosmos DB-fundet fra sikkerhedsoversigten eller den berørte konto i Bo, hvor det er tilgængeligt.

  2. Bekræft den berørte konto, vurderingens navn, vurderede omgivelser og eventuel tilgængelig observationstid. Tjek anbefalingen i forhold til din organisations politik.

  3. Åbn kontoen i Azure-portalen og verificér dens nuværende konfiguration. For Microsoft Entra-autentificering, kundeadministrerede nøgler eller adgang til offentligt netværk skal du følge den tilsvarende Cosmos DB-servicedokumentation.

  4. Vurder applikationens indvirkning og få den nødvendige godkendelse, før du foretager en ændring.

  5. Når den autoriserede ændring er fuldført, skal indstillingen bekræftes i Azure-portalen. Tillad revurdering og opdater Database Hub; hvis fundet fortsætter, sammenlign dets beviser med konfigurationen af løbende konto.

Fejlfinding af Cosmos DB-data i Database Hub

  • Hvis en Cosmos DB-konto ikke vises i Estate, tjek den indloggede lejer, Azure-adgang, ressourcetype, inventarfiltre og autorisation.
  • Hvis performance-metrikker mangler eller er forskellige mellem Azure Monitor og Database Hub:
    • Vælg et tidsinterval, hvor kontoen aktivt bevarede anmodninger. Tjek om metrikken gælder for kontoens API-type; for eksempel adskiller 429-mappingen sig mellem NoSQL (StatusCode 429) og MongoDB API (fejlkode 16500).
    • Åbn den samme konto i Azure-portalen og inspicer den tilsvarende Azure Monitor-metrik under fanen Insights. Match tidszone, start- og sluttidspunkter, aggregation og granularitet så tæt som muligt.
    • Hvis metrikken mangler begge steder, skal du tjekke kontoaktiviteten og antage behandlingsforsinkelse.
    • Hvis Azure Monitor har data, men Database Hub ikke har, så opdater Database Hub-visningen og prøv igen med den konto alene. Hvis forskellen fortsætter, kontakt support.

Begrænsninger

  • Cosmos DB Fleet Analytics understøttes i øjeblikket ikke i Database Hub.
  • Den nuværende forhåndsvisning understøtter kun Azure Cosmos DB-konti. I den nuværende preview understøttes Cosmos DB in Fabric ikke i øjeblikket.
  • I den nuværende forhåndsvisning viser Oversigt og Ydeevne et kurateret delmængde af de metrikker, der er tilgængelige i Azure Monitor.
  • I den nuværende forhåndsvisning er Activator ikke tilgængelig for at advare over Cosmos DB-metrikker.

Relateret indhold

  • Sidst opdateret den