Annotazioni sui grafici delle metriche in Application Insights

Le annotazioni nei grafici di Esplora metriche indicano dove è stata distribuita una nuova build o un altro evento significativo e consentono di verificare facilmente se le modifiche hanno avuto effetto sulle prestazioni dell'applicazione. Possono essere create automaticamente dal sistema di compilazione di Visual Studio Team Services. È anche possibile creare annotazioni da PowerShell per contrassegnare qualsiasi evento.

Esempi di annotazioni con correlazione visibile con il tempo di risposta del server

Annotazioni sulla versione con la build VSTS

Le annotazioni sulla versione sono una funzionalità della build basata sul cloud e del servizio versione di Visual Studio Team Services.

Installare l'estensione Annotazioni (una volta)

Per creare le annotazioni sulla versione, sarà necessario installare una delle numerose estensioni di Team Service disponibili in Visual Studio Marketplace.

  1. Accedere al progetto in Visual Studio Team Services.
  2. Aprire Visual Studio Marketplace, individuare l'estensione delle annotazioni sulla versionee aggiungerla all'account di Team Services.

Nell'angolo in alto a destra della pagina Web di Team Services aprire il marketplace. Scegliere Visual Studio Team Services, quindi nella sezione relativa a compilazione e rilascio scegliere Altre informazioni.

È necessario eseguire questa operazione una sola volta per l'account di Visual Studio Team Services. Le annotazioni sulla versione ora possono essere configurate per qualsiasi progetto nell'account.

Configurare annotazioni sulla versione

È necessario ottenere una chiave API separata per ogni modello di versione VSTS.

  1. Accedere al portale di Microsoft Azure e aprire la risorsa di Application Insights che monitora l'applicazione o crearne una nuova, se necessario.
  2. Aprire Accesso all'API, ID di Application Insights.

    In portal.azure.com, aprire la risorsa di Application Insights e scegliere Settings. Aprire API Access. Copiare l'ID applicazione

  3. In una finestra del browser separata, aprire (o creare) il modello di versione che gestisce le distribuzioni da Visual Studio Team Services.

    Aggiungere un'attività e scegliere l'attività di annotazione sulla versione di Application Insights dal menu.

    Incollare l' ID di Application Insights copiato dal pannello di accesso all'API.

    In Visual Studio Team Services, aprire Release, selezionare una versione di rilascio e scegliere Edit. Fare clic su Add Task e scegliere l'annotazione sulla versione di Application Insights. Incollare l'Id di Application Insights.

  4. Impostare il campo Chiave API su una variabile $(ApiKey).

  5. Nella finestra di Azure creare una nuova chiave API e richiedere una copia.

    Nel Pannello di accesso all'API nella finestra di Azure, fare clic su Crea chiave API. Inserire un commento, controllare le annotazioni di scrittura e fare clic su Genera chiave. Copiare la nuova chiave.

  6. Aprire la scheda Configurazione del modello di versione.

    Creare una definizione di variabile per ApiKey.

    Incollare la chiave API per la definizione della variabile della chiave API.

    Nella finestra Servizi per i team, selezionare la scheda Configurazione e fare clic su Aggiungi variabile. Impostare il nome su ApiKey, incollare in Valore la chiave appena generata e fare clic sull'icona di blocco.

  7. Infine fare clic su Salva per salvare la definizione della versione.

Visualizzare le annotazioni

Ora, quando si usa il modello di versione per distribuire una nuova versione, verrà inviata un'annotazione ad Application Insights. Le annotazioni verranno visualizzate nei grafici di Esplora metriche.

Fare clic su un marcatore di annotazione per visualizzare i dettagli sulla versione, tra cui richiedente, ramo di controllo del codice sorgente, definizione della versione, ambiente e così via.

Fare clic su un marcatore di annotazione della versione.

Creare annotazioni personalizzate da PowerShell

È anche possibile creare le annotazioni da qualsiasi processo desiderato, senza usare VS Team System.

  1. Creare una copia locale dello script di Powershell da GitHub.

  2. Ottenere l'ID applicazione e creare una chiave API dal pannello Accesso all'API.

  3. Chiamare lo script seguente:


     .\CreateReleaseAnnotation.ps1 `
      -applicationId "<applicationId>" `
      -apiKey "<apiKey>" `
      -releaseName "<myReleaseName>" `
      -releaseProperties @{
          "ReleaseDescription"="a description";
          "TriggerBy"="My Name" }

È facile modificare lo script, ad esempio per creare annotazioni per quello precedente.

Passaggi successivi