Annotazioni sui grafici delle metriche in Application InsightsAnnotations on metric charts in Application Insights

Le annotazioni nei grafici di Esplora metriche indicano dove è stata distribuita una nuova build o un altro evento significativoAnnotations on Metrics Explorer charts show where you deployed a new build, or other significant event. e consentono di verificare facilmente se le modifiche hanno avuto effetto sulle prestazioni dell'applicazione.They make it easy to see whether your changes had any effect on your application's performance. Possono essere create automaticamente dal sistema di compilazione di Visual Studio Team Services.They can be automatically created by the Visual Studio Team Services build system. È anche possibile creare annotazioni da PowerShell per contrassegnare qualsiasi evento.You can also create annotations to flag any event you like by creating them from PowerShell.

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

Annotazioni sulla versione con la build VSTSRelease annotations with VSTS build

Le annotazioni sulla versione sono una funzionalità della build basata sul cloud e del servizio versione di Visual Studio Team Services.Release annotations are a feature of the cloud-based build and release service of Visual Studio Team Services.

Installare l'estensione Annotazioni (una volta)Install the Annotations extension (one time)

Per creare le annotazioni sulla versione, sarà necessario installare una delle numerose estensioni di Team Service disponibili in Visual Studio Marketplace.To be able to create release annotations, you'll need to install one of the many Team Service extensions available in the Visual Studio Marketplace.

  1. Accedere al progetto in Visual Studio Team Services.Sign in to your Visual Studio Team Services project.
  2. Aprire Visual Studio Marketplace, individuare l'estensione delle annotazioni sulla versionee aggiungerla all'account di Team Services.In Visual Studio Marketplace, get the Release Annotations extension, and add it to your Team Services account.

Nell'angolo in alto a destra della pagina Web di Team Services aprire il marketplace.

È necessario eseguire questa operazione una sola volta per l'account di Visual Studio Team Services.You only need to do this once for your Visual Studio Team Services account. Le annotazioni sulla versione ora possono essere configurate per qualsiasi progetto nell'account.Release annotations can now be configured for any project in your account.

Configurare annotazioni sulla versioneConfigure release annotations

È necessario ottenere una chiave API separata per ogni modello di versione VSTS.You need to get a separate API key for each VSTS release template.

  1. Accedere al portale di Microsoft Azure e aprire la risorsa di Application Insights che monitora l'applicazioneSign in to the Microsoft Azure Portal and open the Application Insights resource that monitors your application. o crearne una nuova, se necessario.(Or create one now, if you haven't done so yet.)
  2. Aprire Accesso all'API, ID di Application Insights.Open API Access, Application Insights Id.

    In portal.azure.com, aprire la risorsa di Application Insights e scegliere Settings.

  3. In una finestra del browser separata, aprire (o creare) il modello di versione che gestisce le distribuzioni da Visual Studio Team Services.In a separate browser window, open (or create) the release template that manages your deployments from Visual Studio Team Services.

    Aggiungere un'attività e scegliere l'attività di annotazione sulla versione di Application Insights dal menu.Add a task, and select the Application Insights Release Annotation task from the menu.

    Incollare l' ID di Application Insights copiato dal pannello di accesso all'API.Paste the Application Id that you copied from the API Access blade.

    In Visual Studio Team Services, aprire Release, selezionare una versione di rilascio e scegliere Edit.

  4. Impostare il campo Chiave API su una variabile $(ApiKey).Set the APIKey field to a variable $(ApiKey).

  5. Nella finestra di Azure creare una nuova chiave API e richiedere una copia.Back in the Azure window, create a new API Key and take a copy of it.

    Nel Pannello di accesso all'API nella finestra di Azure, fare clic su Crea chiave API.

  6. Aprire la scheda Configurazione del modello di versione.Open the Configuration tab of the release template.

    Creare una definizione di variabile per ApiKey.Create a variable definition for ApiKey.

    Incollare la chiave API per la definizione della variabile della chiave API.Paste your API key to the ApiKey variable definition.

    Nella finestra Servizi per i team, selezionare la scheda Configurazione e fare clic su Aggiungi variabile.

  7. Infine fare clic su Salva per salvare la definizione della versione.Finally, Save the release definition.

Visualizzare le annotazioniView annotations

Ora, quando si usa il modello di versione per distribuire una nuova versione, verrà inviata un'annotazione ad Application Insights.Now, whenever you use the release template to deploy a new release, an annotation will be sent to Application Insights. Le annotazioni verranno visualizzate nei grafici di Esplora metriche.The annotations will appear on charts in Metrics Explorer.

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.Click on any annotation marker to open details about the release, including requestor, source control branch, release definition, environment, and more.

Fare clic su un marcatore di annotazione della versione.

Creare annotazioni personalizzate da PowerShellCreate custom annotations from PowerShell

È anche possibile creare le annotazioni da qualsiasi processo desiderato, senza usare VS Team System.You can also create annotations from any process you like (without using VS Team System).

  1. Creare una copia locale dello script di Powershell da GitHub.Make a local copy of the Powershell script from GitHub.

  2. Ottenere l'ID applicazione e creare una chiave API dal pannello Accesso all'API.Get the Application ID and create an API key from the API Access blade.

  3. Chiamare lo script seguente:Call the script like this:


     .\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.It's easy to modify the script, for example to create annotations for the past.

Passaggi successiviNext steps