Valvo Cosmos-tietokantatiliä Database Hubissa (esikatselu)

Microsoft Fabric Database Hub auttaa sinua löytämään Azure Cosmos DB -tilejä API:n välillä (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.

Seuraa Cosmos DB:tä paikallaan

Cosmos-tietokantatilisi pysyvät Azure-resursseina nykyisissä tilauksissaan, resurssiryhmissään ja alueillaan. Database Hubin käyttäminen löytämiseen ja seurantaan ei vaadi datan siirtämistä Fabric-järjestelmään, peilauksen konfigurointia tai käyttöönottoa Cosmos DB Fleet Analyticsiin.

Tietokantahubin mittarit kuvaavat tiliä, ellei mittari tai suodatinparametri nimenomaisesti tunnista kapeampaa aluetta, kuten tiettyä tietokantaa tai konttia.

• Cosmos DB:n valvonta Database Hubissa käyttää olemassa olevia Azure Monitor -alustan mittareita, jotka kerätään automaattisesti jokaiselle tilille ilman tarkkaa konfiguraatiota.
• Sinun ei tarvitse ottaa käyttöön diagnostiikka- (resurssi-) lokeja tai integroida Cosmos DB Fleet Analyticsiin.
• Azure Monitor ja Fleet Analytics ovat erillisiä, valinnaisia työkaluja syvällisempään tutkimukseen, eikä niitä tarvita perusmittareiden täyttämiseen.

Edellytykset

• Nykyisessä esikatselussa pyydä Fabric-ylläpitäjää valitsemaan vuokralainen Database Hubin esikatselukokemukseen Fabric-hallintaportaalissa. Tenant-asetuksissa, ota käyttöön. Käyttäjät voivat käyttää tietokantahubia (esikatselu).

• Aloita ilmaisella kokemuksella kirjautumalla sisään työ- tai koulutililläsi. Voit osallistua Azure-portaalista tai suoraan Microsoft Fabric -palvelusta, vaikka et olisi käyttänyt Fabric:ia aiemmin. Tunnistaudu Microsoft Entra -identiteetillä, jolla on pääsy Azure-tilauksiin ja Cosmos DB -resursseihin, joiden kanssa haluat työskennellä. Azure-resurssien näkyvyys yksin ei anna oikeutta tietokannan kyselyyn. Database Hub käyttää olemassa olevia Microsoft Entra ID- ja Azure RBAC -käyttöoikeuksia erillistä käyttöoikeusmallin sijaan, joten täällä annettu pääsy noudattaa Azure-roolien määritysvaiheita.

  • Löytääksesi ja seurataksesi Cosmos DB -tilejä, määritä lukijarooli tai rooli, jolla on suurempi käyttöoikeus, tilausalueella jokaiselle tilaukselle, jossa haluat seurata tilejä.
  • Uuden Cosmos DB -tilin luomiseksi Database Hubista määritetään Cosmos DB -operaattorin rooli tai rooli, jolla on suuremmat oikeudet, resurssiryhmän alueelle, jossa tili luodaan.
  • Olemassa olevan tilin hallinta tai uudelleenkonfigurointi, kuten läpimenokyvyn, indeksoinnin tai verkkoasetusten muuttaminen, tapahtuu Database Hubin ulkopuolella Azure-portaalin, Azure CLI:n, Azure PowerShell:n tai Azure Resource Manager -mallipohjan avulla. Sama identiteetti tarvitsee Cosmos DB Operatorin roolin, eli roolin, jolla on suurempi käyttöoikeus, tilin laajuudessa, jotta nämä muutokset voidaan tehdä siellä.

• Tietokannan tai kontin tietojen kyselyyn henkilöllisyytesi tarvitsee erillisen Cosmos DB -datatasoroolin (tai tiliavaimet, jos sallittu) sekä verkkoyhteyden tilille. Resurssitason (hallintataso) pääsy ei anna tätä lupaa. Lisätietoja saat kohdasta Connect using role based access control ja Microsoft Entra ID for Azure Cosmos DB.

• Database Hub kunnioittaa olemassa olevia käyttöoikeusrajojasi. Tietokantakeskus ei anna lisäpääsyä. Näkyvyytesi tietokantoihin rajoittuu resursseihin, joita nykyinen henkilöllisyytesi on valtuutettu katsomaan. Näkymän jakaminen tai resurssilinkin lähettäminen ei anna heille pääsyä taustalla olevaan palvelimeen.

Katso Cosmos DB -omaisuutesi

Käytä Database Hubia tunnistaaksesi tutkittavia resursseja. Jatka Azure-portaalissa tai Visual Studio Code:ssa tilin konfigurointiin, konttitason työhön tai kyselydiagnostiikkaan.

1. Mene Microsoft Fabric -tietokantakeskukseen. Tietokantojen navigoinnissa valitse Yleiskatsaus.
2. Mitä vaatii huomiota? -osio osoittaa tietokantasi omaisuuden osia, jotka kaipaavat huomiota. Jokainen kortti ja linkki Missä on huomiota? johtaa perintöön. Kartanonäkymässä, jokaisen resurssin alla, numerot näkyvät värikkäissä siruissa ja ehdotukset siruissa, joissa on lamppukuvake.
3. Suodata inventaario muotoon View: Azure Cosmos DB. Valitse asiaankuuluvat tilaukset tai resurssiryhmät käytettävissä olevien suodattimien avulla.
4. Etsi tarvitsemasi tili tai tarkista suodatettu varasto. Valitse tili tarkistaaksesi sen resurssitiedot. Käsittele tätä tiliä Azure-tilin resurssina, älä yksittäisenä tietokantana tai konttina.

Cosmos DB:n seurantamittarit Database Hubissa

Yleiskatsaus tuo esiin saatavuuden ja normalisoidut RU:n kulutuksen yhteenvedot Cosmos DB -tilisi resursseissa.

Hyvin varustellulla ja aktiivisesti käytetyllä tilillä on normaalia, että molemmat linjat ovat useimmiten tasolla 100%. Korkea RU:n kulutus tarkoittaa, että tili käyttää suurimman osan tai kaiken sen generoidusta läpimenonopeudesta. Onko se ok, riippuu saatavuudesta samassa ikkunassa.

• Korkea saatavuus tarkoittaa, että pyynnöt onnistuvat edelleen, ja tili hyödyntää täysimääräisesti sitä, mitä on asetettu.
• Saatavuuden lasku samanaikaisesti johtaa todellisiin rajoitettuihin tai epäonnistuneisiin pyyntöihin, koska jatkuva maksimaalinen RU-kulutus on sama ehto, joka laukaisee nopeuden rajoituksen.

Kiinnitä tarkempaa huomiota, kun saatavuus laskee selvästi alle 100%. Seuraa myös, että RU:n kulutus pysyy matalana pitkän aikaa, mikä voi viitata ylitarjottuun läpimenoon.

Suorituskyky antaa sinulle tarkemman katsauksen tiettyihin tileihin, jotka valitset nimenomaisesti. Se ei automaattisesti sisällä kaikkia tilejä Estatessa, ja jos suodattimia ei ole käytössä, Suorituskykytaulukko rajoittaa näkymän ensimmäisiin 100 resurssiin, jotta sivu pysyy responsiivisena. Ennen kuin käsittelet suorituskykykaaviota koko pesän kattavana, varmista, mitkä tilit ovat tällä hetkellä valittuja, sillä laajuus ja koko perintövarastosi voivat vaihdella.

Telemetrian puuttuminen ei tarkoita nollakäyttöä tai todiste siitä, että tili on terve. Tarkista, tuottiko tili dataa valitun ajanjakson aikana ja sovelletaanko mittari sen API-tyyppiin ja konfiguraatioon.

Tulkitse Cosmos DB:n suorituskykysignaaleja

Tämän sivun kaavioissa käytetään tuntikohtaista aikarakeisuutta: 24 tunnin näkymä piirtää 24 pistettä käyttäen siihen liittyvää aggregaatiota. Ruudukko käyttää eri aikarakeisuutta ja pienentää koko valitun vaihteluvälin yhteen arvoon tiliä kohden per sarake sen sijaan, että pisteitä piirrettäisiin ajan kuluessa. Esimerkiksi ruudukon Peak Norm RU % on maksimi, joka havaitaan missä tahansa kyseisellä alueella, ei tuntikohtainen erittely.

Lisätietoja löytyy kohdasta Monitor Azure Cosmos DB ja Supported metrics for Microsoft. DocumentDB/databaseAccounts.

Tulkitse Cosmos DB:n tietoturva- ja kyvykkyyseroja

Tietokantakeskuksen Tietoturva-sivu arvioi kolme Cosmos DB:n signaalia:

• Microsoft Entra ID -tunnistautuminen: vaatiiko tili Entra ID -tunnus:n pelkkää tunnistautumista vai salliiko se edelleen paikallisen (avainpohjaisen) tunnistautumisen.
• Asiakkaan hallinnoimat avaimet (CMK): riippuu, onko CMK-salaus käytössä vai riippuuko tili palvelun hallinnoimista avaimista.
• Julkinen verkkoyhteys: onko tilillä se käytössä.

Jos tili sallii paikallisen tunnistautumisen tai siinä ei ole CMK:ta käytössä, Database Hub listaa sen ehdotukseksi, joka on valinnainen parannus, jonka voit tehdä kätevästi. Tili, jolla on julkisen verkon käyttö päällä, merkitään Ongelmaksi, koska sitä käsitellään aikakriittisempänä.

Tietokantahubin signaali heijastaa sitä, mitä se tällä hetkellä arvioi, ei välttämättä tilin taustalla olevan tietoturvakonfiguraation täydellistä tilaa. Esimerkiksi tilillä, jossa CMK ei ole käytössä, salaus on oletuksena Microsoft-hallinnoimien avainten kautta, joten lippu tässä tarkoittaa "ei käytössä tälle ominaisuudelle" eikä "suojaamaton". Varmista tilin nykyinen asetus Azure-portaalissa ennen kuin toimit löydöksen perusteella. Katso lisätietoja kohdista Configure customer-managed keys for Azure Cosmos DB ja Encryption at rest in Azure Cosmos DB.

Nämä turvasignaalit tarjoavat nopean näkymän, joka auttaa sinua triagessa. Täydellistä tietoturva-arviointia ja korjausta varten käytä palveluita kuten Microsoft Defender for Cloud ja tilisi diagnostiikkalokit yhdessä Database Hubin kanssa.

Jatka tutkimusta Azure-portaalissa

Voit käyttää Azure-portaalia tutkiaksesi tarkemmin mahdollisia ongelmia, esimerkiksi vertailla saman tilin mittareita rinnakkain Database Hubissa ja Azure-portaalissa.

1. Valitse tarkoitettu Cosmos DB -tili Database Hubista. Kyseisen kohteen paneeli avautuu Database Hubiin.
2. Valitse Avaa Azure-portaali -painike.
3. Mene Insights-välilehdelle ja aseta aikaväli. Vertaa asiaankuuluvia mittareita sopivan seurantajakson aikana.

Nykyisessä esikatselussa Azure-portaalin Insights-välilehti tarjoaa laajemman valikoiman kaavioita ja mittareita, joten käytä sitä signaaleihin, joita Database Hub ei vielä ilmesty.

Tutki Cosmos DB:n tietoturvalöydöksiä

1. Valitse Cosmos DB -löydös Tietoturva-yhteenvedosta tai Estate-tilin vaikutusvaltainen tili, jos saatavilla.

2. Vahvista vaikutuksen mukainen tili, arvioinnin nimi, arvioitu ympäristö ja mahdollinen käytettävissä oleva havainnointiaika. Tarkista suositus organisaatiosi käytännöistä.

3. Avaa tili Azure-portaalissa ja tarkista sen nykyinen asetus. Microsoft Entra -todennuksessa, asiakkaan hallinnoimissa avaimissa tai julkisessa verkkokäytössä noudata vastaavaa Cosmos DB -palveludokumentaatiota.

4. Arvioi sovelluksen vaikutus ja hanki vaadittu hyväksyntä ennen muutoksen tekemistä.

5. Kun valtuutettu muutos on valmis, tarkista asetus Azure-portaalissa. Mahdollista uudelleenarviointi ja Database Hubin päivittäminen; jos havainto säilyy, vertaa sen todisteita nykyisen tilin konfiguraatioon.

Vianmääritys Cosmos DB -datasta Database Hubissa

• Jos Cosmos DB -tiliä ei näy Estate-tilillä, tarkista kirjautunut vuokralainen, Azure-käyttöoikeus, resurssityyppi, varastosuodattimet ja valtuutus.
• Jos suorituskykymittarit puuttuvat tai eroavat Azure Monitor:n ja Database Hubin välillä:
  • Valitse aikaväli, jolloin tili palveli aktiivisesti pyyntöjä. Tarkista, koskeeko mittari tilin API-tyyppiä; esimerkiksi 429-kartoitus eroaa NoSQL:n (StatusCode 429) ja MongoDB API:n (virhekoodi 16500) välillä.
  • Avaa sama tili Azure-portaalissa ja tarkista vastaava Azure Monitor -mittari Insights-välilehdellä. Sovita aikavyöhyke, aloitus- ja lopetusajat, aggregaatio ja yksityiskohtaisuus mahdollisimman tarkasti.
  • Jos mittari puuttuu molemmista paikoista, tarkista tilin aktiivisuus ja salli käsittelyviive.
  • Jos Azure Monitor sisältää dataa mutta Database Hubissa ei, päivitä Database Hub -näkymä ja yritä uudelleen pelkällä tilillä. Jos ero jatkuu, ota yhteyttä tukeen.

Rajoitukset

• Cosmos DB Fleet Analytics ei tällä hetkellä ole tuettu Database Hubissa.
• Nykyinen esikatselu tukee vain Azure Cosmos DB -tilejä. Nykyisessä esikatselussa Cosmos DB in Fabric ei ole tällä hetkellä tuettu.
• Nykyisessä esikatselussa Yleiskatsaus ja suorituskyky esittelevät Azure Monitor -ohjelman käytettävissä olevien mittareiden valikoidun osajoukon.
• Nykyisessä esikatselussa Aktivaattorin hälytykset Cosmos DB -mittareiden yli eivät ole saatavilla.

Liittyvä sisältö

• Valvo Azure Cosmos DB:tä
• Tuetut mittarit Microsoftille. DocumentDB/databaseAccounts
• Yhdistä roolipohjaisen käyttöoikeudenhallinnan ja Microsoft Entra ID:n avulla Azure Cosmos DB:lle
• Fleet Analytics for Azure Cosmos DB
• Visual Studio Code extension for Azure Cosmos DB