Az Azure Cosmos DB for NoSQL teljesítményének mérése teljesítményértékelési keretrendszerrel

Mostantól minden eddiginél több választási lehetőség áll rendelkezésre az adatterheléshez használható adatbázis típusára. Az adatbázis kiválasztásának egyik fő tényezője az adatbázis vagy szolgáltatás teljesítménye, de a teljesítménytesztelés nehézkes és hibalehetőséget jelenthet. Az Azure Databases teljesítményértékelési keretrendszere leegyszerűsíti a teljesítmény mérésének folyamatát a népszerű nyílt forráskódú teljesítményértékelési eszközökkel, alacsony súrlódású receptekkel, amelyek a gyakori ajánlott eljárásokat implementálják. Az Azure Cosmos DB for NoSQL-ben a keretrendszer a Java SDK ajánlott eljárásait valósítja meg, és a nyílt forráskódú YCSB-eszközt használja. Ebben az útmutatóban ezt a teljesítménytesztelési keretrendszert használja egy olvasási számítási feladat implementálásához a keretrendszer megismeréséhez.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Hozzon létre ingyenes fiókot.
• Azure Cosmos DB for NoSQL-fiók. Hozzon létre egy API-t a NoSQL-fiókhoz.
  • Jegyezze fel a fiók végponti URI-jának és elsődleges kulcsának adatait. A NoSQL elsődleges kulcsainak API-ja.
• Azure Storage-fiók. Hozzon létre egy Azure Storage-fiókot.
  • Jegyezze fel a tárfiók kapcsolati sztring. Vies Azure Storage kapcsolati sztring.
• Második üres erőforráscsoport. Hozzon létre egy erőforráscsoportot.
• Azure Command-Line Interface (CLI).

Azure Cosmos DB-fiókerőforrások létrehozása

Először létre kell hoznia egy adatbázist és egy tárolót a meglévő NOSQL-fiók API-jában.

Azure Portal

1. Lépjen a meglévő NOSQL-fiókhoz az Azure Portal.

2. Az erőforrásmenüben válassza a Data Explorer lehetőséget.

   

3. A Data Explorer lapon válassza az Új tároló lehetőséget a parancssávon.

   

4. Az Új tároló párbeszédpanelen hozzon létre egy új tárolót a következő beállításokkal:

   Beállítás	Érték
   Adatbázis azonosítója	ycsb
   Adatbázis átviteli sebességének típusa	Kézi
   Adatbázis átviteli sebességének mennyisége	400
   Tároló azonosítója	usertable
   Partíciókulcs	/id

   

Azure CLI

1. Ha még nem tette meg, jelentkezzen be az Azure CLI-be a az login paranccsal.

2. Hozzon létre rendszerhéjváltozókat a következő értékekhez:

   • A meglévő Azure Cosmos DB for NoSQL-fiók neve cosmosAccountName.
   • Az első erőforráscsoport neve a nevű sourceResourceGroupNameerőforrással.
   • A második üres erőforráscsoport neve.targetResourceGroupName
   • Meglévő Azure Cosmos DB for NoSQL-fiókvégpont URI neve cosmosEndpoint
   • Meglévő Azure Cosmos DB for NoSQL-fiók elsődleges kulcsa neve cosmosPrimaryKey

   # Variable for Azure Cosmos DB for NoSQL account name
   cosmosAccountName="<cosmos-db-nosql-account-name>"
   
   # Variable for resource group with Azure Cosmos DB and Azure Storage accounts
   sourceResourceGroupName="<first-resource-group-name>"
   
   # Variable for empty resource group
   targetResourceGroupName="<second-resource-group-name>"
   
   # Variable for API for NoSQL endpoint URI
   cosmosEndpoint="<cosmos-db-nosql-endpoint-uri>"
   
   # Variable for API for NoSQL primary key
   cosmosPrimaryKey="<cosmos-db-nosql-primary-key>"
   
   # Variable for Azure Storage account name
   storageAccountName="<storage-account-name>"
   
   # Variable for storage account connection string
   storageConnectionString="<storage-connection-string>"
   

3. az cosmosdb sql database create A paranccsal hozzon létre egy új adatbázist a következő beállításokkal:

   Beállítás	Érték
   Adatbázis azonosítója	ycsb
   Adatbázis átviteli sebességének típusa	Kézi
   Adatbázis átviteli sebességének mennyisége	400

   az cosmosdb sql database create \
       --resource-group $sourceResourceGroupName \
       --account-name $cosmosAccountName \
       --name "ycsb" \
       --throughput 400
   

4. az cosmosdb sql container create A paranccsal hozzon létre egy új tárolót a következő beállításokkal:

   Beállítás	Érték
   Adatbázis azonosítója	ycsb
   Tároló azonosítója	usertable
   Partíciókulcs	/id

   az cosmosdb sql container create \
       --resource-group $sourceResourceGroupName \
       --account-name $cosmosAccountName \
       --database-name "ycsb" \
       --name "usertable" \
       --partition-key-path "/id"
   

Teljesítménytesztelési keretrendszer üzembe helyezése az Azure-ban

Most egy Azure Resource Manager-sablont használva üzembe helyezheti a teljesítménytesztelési keretrendszert az Azure-ban az alapértelmezett olvasási recepttel.

Azure Portal

1. Helyezze üzembe a teljesítménytesztelési keretrendszert az ezen a hivatkozáson elérhető Azure Resource Manager-sablonnal.

   

2. Az Egyéni üzembe helyezés lapon az alábbi paraméterek

   

3. A sablon üzembe helyezéséhez válassza a Véleményezés + létrehozás , majd a Létrehozás lehetőséget.

4. Várjon, amíg az üzembe helyezés befejeződik.

   Tipp

   Az üzembe helyezés 5–10 percet is igénybe vehet.

Azure CLI

1. A az deployment group create teljesítménytesztelési keretrendszer üzembe helyezéséhez egy Azure Resource Manager-sablont használ.

   # Variable for raw template JSON on GitHub
   templateUri="https://raw.githubusercontent.com/Azure/azure-db-benchmarking/main/cosmos/sql/tools/java/ycsb/recipes/read/try-it-read/azuredeploy.json"
   
   az deployment group create \
       --resource-group $targetResourceGroupName \
       --name "benchmarking-framework" \
       --template-uri $templateUri \
       --parameters \
           adminPassword='P@ssw.rd' \
           resultsStorageConnectionString=$storageConnectionString \
           cosmosURI=$cosmosEndpoint \
           cosmosKey=$cosmosPrimaryKey
   

2. Várjon, amíg az üzembe helyezés befejeződik.

   Tipp

   Az üzembe helyezés 5–10 percet is igénybe vehet.

A teljesítményteszt eredményeinek megtekintése

Most a meglévő Azure Storage-fiókkal ellenőrizheti a teljesítményteszt-feladat állapotát, és megtekintheti az összesített eredményeket. Az állapot tárolása egy tárolótáblával történik, és az eredmények CSV-formátumban vannak összesítve egy tárolóblobban.

Azure Portal

1. Lépjen a meglévő Azure Storage-fiókjára a Azure Portal.

2. Keresse meg az ycsbbenchmarkingmetadata nevű tárolótáblát, és keresse meg az entitást a partíciókulcsával ycsb_sql.

   

3. Figyelje meg a JobStatus táblaentitás mezőjét. Kezdetben a feladat állapota, Started és a tulajdonságban JobStartTime szerepel egy időbélyeg, de a JobFinishTime tulajdonság nem.

4. Várjon, amíg a feladat állapota Finished és a tulajdonság tartalmaz JobFinishTime egy időbélyeget.

   Tipp

   A feladat befejezése körülbelül 20–30 percet vehet igénybe.

5. Lépjen az ugyanabban a fiókban található tárolóra az ycsbbenchmarking-*előtaggal. Figyelje meg az eszköz kimenetét és diagnosztikai blobokat.

   

6. Nyissa meg a aggregation.csv blobot, és figyelje meg a tartalmat. Most már rendelkeznie kell egy CSV-adatkészlettel, amely az összes teljesítményteszt-ügyfél összesített eredményeit jeleníti meg.

   

   Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
   READ,180000,299,706,448255,1079,1159,2867
   

Azure CLI

1. A feladatrekord lekérdezése egy nevű ycsbbenchmarkingmetadata tárolótáblában a használatával az storage entity query.

   az storage entity query \
       --account-name $storageAccountName \
       --connection-string $storageConnectionString \
       --table-name ycsbbenchmarkingmetadata
   

2. Figyelje meg a lekérdezés eredményeit. Az eredményeknek egyetlen feladatot kell visszaadnia, amely a , JobStatusa és a JobFinishTime tulajdonsággal JobStartTimerendelkezik. Kezdetben a feladat állapota, Started és a tulajdonságban JobStartTime szerepel egy időbélyeg, de a JobFinishTime tulajdonság nem.

   {
     "items": [
       {
         "JobFinishTime": "",
         "JobStartTime": "2023-02-02T13:59:42Z",
         "JobStatus": "Started",
         "NoOfClientsCompleted": "0",
         "NoOfClientsStarted": {
           "edm_type": "Edm.Int64",
           "value": 1
         },
         "PartitionKey": "ycsb_sql",
         ...
       }
     ],
     ...
   }
   

3. Ha szükséges, futtassa az storage entity query többször, amíg a feladat állapota Finished nem lesz, és tartalmaz egy időbélyeget a JobFinishTime tulajdonságban.

   {
     "items": [
       {
         "JobFinishTime": "2023-02-02T14:21:12Z",
         "JobStartTime": "2023-02-02T13:59:42Z",
         "JobStatus": "Finished",
         ...
       }
     ],
     ...
   }
   

   Tipp

   A feladat befejezése körülbelül 20–30 percet vehet igénybe.

4. Keresse meg a legutóbb módosított tároló nevét a használat az storage container list előtagjával ycsbbenchmarking-* és egy JMESPath-lekérdezéssel.

   az storage container list \
       --account-name $storageAccountName \
       --connection-string $storageConnectionString \
       --query "sort_by([?starts_with(name, 'ycsbbenchmarking-')], &properties.lastModified)[-1].name" \
       --output tsv
   

5. Tárolja a tárolósztringet egy nevű storageConnectionStringváltozóban.

   storageContainerName=$( \
       az storage container list \
           --account-name $storageAccountName \
           --connection-string $storageConnectionString \
           --query "sort_by([?starts_with(name, 'ycsbbenchmarking-')], &properties.lastModified)[-1].name" \
           --output tsv \
   )
   

6. A feladat lekérdezéséhez használja a [az storage blob query]/cli/azure/storage/blob#az-storage-blob-query parancsot, amely egy, a korábban található tárolóban tárolt tárolóblobot eredményez.

   az storage blob query \
       --account-name $storageAccountName \
       --connection-string $storageConnectionString \
       --container-name $storageContainerName \
       --name aggregation.csv \
       --query-expression "SELECT * FROM BlobStorage"
   

7. Figyelje meg a lekérdezés eredményeit. Most már rendelkeznie kell egy CSV-adatkészlettel, amely az összes teljesítményteszt-ügyfél összesített eredményeit jeleníti meg.

   Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
   READ,180000,299,706,448255,1079,1159,2867
   

Receptek

Az Azure Databases teljesítményértékelési keretrendszere olyan recepteket tartalmaz, amelyek az alapul szolgáló teljesítménytesztelési eszköznek átadott számítási feladatok definícióit tartalmazzák egy "1 kattintásos" élmény érdekében. A számítási feladatok definícióit az Azure Cosmos DB csapata és a teljesítménytesztelő eszköz csapata által közzétett ajánlott eljárások alapján tervezték. A recepteket tesztelték és ellenőrizték a konzisztens eredmények érdekében.

A GitHub-adattár összes olvasási és írási receptjéhez az alábbi késések várhatók.

• Olvasási késés

  

• Írási késés

  

Gyakori problémák

Ez a szakasz azokat a gyakori hibákat tartalmazza, amelyek a teljesítménytesztelő eszköz futtatásakor fordulhatnak elő. Az eszköz hibanaplói általában az Azure Storage-fiókban lévő tárolóban érhetők el.

• Ha a naplók nem érhetők el a tárfiókban, ezt a problémát általában helytelen vagy hiányzó tárolási kapcsolati sztring okozza. Ebben az esetben ez a hiba szerepel az ügynök.out fájlban az ügyfél virtuális gép /home/benchmarking mappájában.

  Error while accessing storage account, exiting from this machine in agent.out on the VM
  

• Ez a hiba az ügynök.out fájlban szerepel az ügyfél virtuális gépén és a tárfiókban is, ha az Azure Cosmos DB-végpont URI-ja helytelen vagy nem érhető el.

  Caused by: java.net.UnknownHostException: rtcosmosdbsss.documents.azure.com: Name or service not known 
  

• Ez a hiba az ügynök.out fájlban szerepel az ügyfél virtuális gépén és a tárfiókban is, ha az Azure Cosmos DB-kulcs helytelen.

  The input authorization token can't serve the request. The wrong key is being used….
  

Következő lépések

• További információ a teljesítménytesztelő eszközről az Első lépések útmutatóval.