Gebruiksgegevens uploaden naar Azure in indirecte modus

Periodiek kunt u gebruiksgegevens exporteren. Met het exporteren en uploaden van deze informatie worden de gegevenscontroller, het beheerde SQL-exemplaar en postgreSQL-resources in Azure gemaakt en bijgewerkt.

Notitie

Gebruiksgegevens worden automatisch geüpload voor azure Arc-gegevenscontroller die is geïmplementeerd in de modus voor directe connectiviteit. De instructies in dit artikel zijn alleen van toepassing op het uploaden van gebruiksgegevens voor Azure Arc-gegevenscontroller die is geïmplementeerd in de indirecte connectiviteitsmodus.

Wacht ten minste 24 uur nadat u de Azure Arc-gegevenscontroller hebt gemaakt voordat u gebruiksgegevens uploadt.

Service-principal maken en rollen toewijzen

Voordat u verdergaat, moet u ervoor zorgen dat u de vereiste service-principal hebt gemaakt en aan een juiste rol hebt toegewezen. Zie deze artikelen voor meer informatie:

In voorbeelden in dit artikel worden punthaken < ... > gebruikt om waarden te identificeren die u moet vervangen voordat u het script uitvoert. Vervang de vierkante haken en de waarden tussen de haken.

Gebruiksgegevens uploaden

Gebruiksgegevens zoals inventaris en resourcegebruik kunnen in twee stappen naar Azure worden geüpload:

  1. Exporteer de gebruiksgegevens als volgt met behulp van az arcdata dc export de opdracht:

Notitie

Voor het exporteren van gebruiks-/factureringsgegevens, metrische gegevens en logboeken met behulp van de opdracht az arcdata dc export moet SSL-verificatie voorlopig worden overgeslagen. U wordt gevraagd SSL-verificatie te omzeilen of u kunt de AZDATA_VERIFY_SSL=no omgevingsvariabele instellen om te voorkomen dat u hierom wordt gevraagd. Er is momenteel geen manier om een SSL-certificaat te configureren voor de export-API van de gegevenscontroller.

az arcdata dc export --type usage --path usage.json --k8s-namespace <namespace> --use-k8s

Met deze opdracht maakt u een usage.json bestand met alle gegevensbronnen met Azure Arc, zoals SQL Managed Instances en PostgreSQL-exemplaren, enzovoort die op de gegevenscontroller worden gemaakt.

Het bestand is voorlopig niet versleuteld, zodat u de inhoud kunt zien. U kunt de inhoud openen in een teksteditor en zien hoe de inhoud eruitziet.

U ziet dat er twee gegevenssets zijn: resources en data. Dit resources zijn de gegevenscontroller, PostgreSQL en SQL Managed Instances. De resources records in de gegevens leggen de relevante gebeurtenissen vast in de geschiedenis van een resource: wanneer deze is gemaakt, wanneer deze is bijgewerkt en wanneer deze is verwijderd. De data records leggen vast hoeveel kernen er elk uur door een bepaald exemplaar kunnen worden gebruikt.

Voorbeeld van een resource vermelding:

    {
        "customObjectName": "<resource type>-2020-29-5-23-13-17-164711",
        "uid": "4bc3dc6b-9148-4c7a-b7dc-01afc1ef5373",
        "instanceName": "sqlInstance001",
        "instanceNamespace": "arc",
        "instanceType": "<resource>",
        "location": "eastus",
        "resourceGroupName": "production-resources",
        "subscriptionId": "482c901a-129a-4f5d-86e3-cc6b294590b2",
        "isDeleted": false,
        "externalEndpoint": "32.191.39.83:1433",
        "vCores": "2",
        "createTimestamp": "05/29/2020 23:13:17",
        "updateTimestamp": "05/29/2020 23:13:17"
    }

Voorbeeld van een data vermelding:

        {
          "requestType": "usageUpload",
          "clusterId": "4b0917dd-e003-480e-ae74-1a8bb5e36b5d",
          "name": "DataControllerTestName",
          "subscriptionId": "482c901a-129a-4f5d-86e3-cc6b294590b2",
          "resourceGroup": "production-resources",
          "location": "eastus",
          "uploadRequest": {
            "exportType": "usages",
            "dataTimestamp": "2020-06-17T22:32:24Z",
            "data": "[{\"name\":\"sqlInstance001\",
                       \"namespace\":\"arc\",
                       \"type\":\"<resource type>\",
                       \"eventSequence\":1, 
                       \"eventId\":\"50DF90E8-FC2C-4BBF-B245-CB20DC97FF24\",
                       \"startTime\":\"2020-06-17T19:11:47.7533333\",
                       \"endTime\":\"2020-06-17T19:59:00\",
                       \"quantity\":1,
                       \"id\":\"4BC3DC6B-9148-4C7A-B7DC-01AFC1EF5373\"}]",
           "signature":"MIIE7gYJKoZIhvcNAQ...2xXqkK"
          }
        }
  1. Upload de gebruiksgegevens met behulp van de upload opdracht.

    az arcdata dc upload --path usage.json
    

Uploadfrequentie

In de indirecte modus moet gebruiksgegevens ten minste eenmaal in elke 30 dagen naar Azure worden geüpload. Het wordt ten zeerste aanbevolen om vaker te uploaden, zoals dagelijks. Als gebruiksgegevens niet de afgelopen 32 dagen worden geüpload, ziet u een verslechtering van de service, zoals het niet kunnen inrichten van nieuwe resources.

Er zijn twee typen meldingen voor vertraagde uploads van gebruik: waarschuwingsfase en gedegradeerde fase. In de waarschuwingsfase is er een bericht zoals Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Please upload billing data as soon as possible..

In de gedegradeerde fase ziet het bericht er als volgt Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Some functionality will not be available until the billing data is uploaded.uit.

Notitie

U ziet het waarschuwingsbericht als het gebruik langer dan 48 uur niet is geüpload.

De overzichtspagina van Azure Portal voor gegevenscontroller en de status van de aangepaste resource van de gegevenscontroller in uw kubernetes-cluster geven zowel de laatste uploaddatum als de statusberichten aan.

Uploads automatiseren (optioneel)

Als u metrische gegevens en logboeken op een geplande basis wilt uploaden, kunt u een script maken en deze elke paar minuten uitvoeren op een timer. Hieronder ziet u een voorbeeld van het automatiseren van de uploads met behulp van een Linux-shellscript.

Voeg in uw favoriete tekst-/code-editor het volgende script toe aan het bestand en sla het op als een uitvoerbaar scriptbestand, zoals .sh (Linux/Mac) of .cmd, .batof .ps1.

az arcdata dc export --type usage --path usage.json --force --k8s-namespace <namespace> --use-k8s
az arcdata dc upload --path usage.json

Het uitvoerbare scriptbestand maken

chmod +x myuploadscript.sh

Voer het script elke dag uit voor gebruik:

watch -n 1200 ./myuploadscript.sh

U kunt ook een jobplanner zoals cron of Windows Task Scheduler of een orchestrator zoals Ansible, Puppet of Chef gebruiken.

Metrische gegevens en logboeken uploaden naar Azure Monitor

Logboeken uploaden naar Azure Monitor

Factureringsgegevens uploaden naar Azure en deze weergeven in Azure Portal

Azure Arc-gegevenscontrollerresource weergeven in Azure Portal