Upload usage data to Azure in indirect mode

Periodiek kunt u gebruiksgegevens exporteren. Met het exporteren en uploaden van deze informatie wordt de gegevenscontroller en het beheerde SQL-exemplaar gemaakt en bijgewerkt.

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 geschikte rol hebt toegewezen. Zie deze artikelen voor meer informatie:

• Maak een serviceprincipal.
• Rollen toewijzen aan de service-principal

In voorbeelden in dit artikel worden punthaken < ... > gebruikt om waarden te identificeren die u moet vervangen voordat u het script uitvoert. Vervang de haken en de waarde in 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:

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 die zijn gemaakt op de gegevenscontroller.

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 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 beschikbaar waren voor gebruik door een bepaald exemplaar.

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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "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"
          }
        }

2. Upload de gebruiksgegevens met behulp van de upload opdracht.

   az arcdata dc upload --path usage.json
   

Upload frequency

In the indirect mode, usage information needs to be uploaded to Azure at least once in every 30 days. 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.

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.

Related content

Metrische gegevens en logboeken uploaden naar Azure Monitor

Logboeken uploaden naar Azure Monitor

Factureringsgegevens uploaden naar Azure en deze weergeven in Azure Portal

Bekijk Azure Arc-gegevenscontrollerresource in Azure Portal