Condividi tramite

Creare un hook del servizio per Azure DevOps con Datadog

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

È possibile creare eventi e metriche in Datadog in risposta agli eventi in Azure DevOps. In Datadog è possibile usare queste metriche ed eventi per creare dashboard, risolvere i problemi e creare monitoraggi per segnalare problemi critici. Datadog accetta tutti i tipi di eventi di Azure DevOps.

Questo articolo illustra come usare gli hook del servizio per inviare eventi di Azure DevOps a Datadog.

Importante

La funzionalità Datadog potrebbe non essere attivata per impostazione predefinita in Azure DevOps Server 2020 e 2019, che è un problema noto. Fino a quando non viene risolto, è possibile usare il comando SQL seguente nel database Tfs_Configuration per attivare la funzionalità:

exec prc_SetRegistryValue 1, '#\FeatureAvailability\Entries\ServiceHooks.Consumers.datadog\AvailabilityState\', 1

Prerequisiti

Categoria Requisiti
Autorizzazioni - Membro del gruppo Amministratori Progetto di Raccolta . I proprietari dell'organizzazione sono automaticamente membri di questo gruppo.
- Modifica le sottoscrizioni e Visualizza le sottoscrizioni con permessi impostati su Consenti. Per impostazione predefinita, solo gli amministratori del progetto dispongono di queste autorizzazioni. Per concedere le autorizzazioni ad altri utenti, è possibile usare lo strumento da riga di comando o l'API REST di sicurezza .
Strumenti Datadog. Nell'applicazione Datadog, vai al tuo profilo e quindi seleziona Impostazioni organizzazione>Chiavi API. Creare una nuova chiave o selezionarne una esistente e quindi copiare la chiave negli Appunti.

Inviare eventi di Azure DevOps a Datadog

Per inviare eventi di Azure DevOps a Datadog, è necessario configurare una sottoscrizione per ogni tipo di evento.

Creare una sottoscrizione per un evento

  1. Passare al progetto Azure DevOps, selezionare Impostazioni progetto e quindi Service hooks. In alternativa, passare a https://{organization-name}/{project-name}/_settings/serviceHooks.

  2. Selezionare Crea sottoscrizione.

    Screenshot della pagina Service Hooks di un progetto Azure DevOps. Il pulsante Crea sottoscrizione è evidenziato.

  3. Nell'elenco dei servizi selezionare Datadog e quindi avanti.

    Screenshot della pagina di Servizio nella procedura guidata per la nuova sottoscrizione degli hook di servizio. Nell'elenco dei servizi, Datadog è evidenziato. Anche 'Successivo' è evidenziato.

  4. Selezionare un evento da attivare, configurare tutti i filtri da usare e quindi selezionare Avanti.

    Screenshot della pagina Trigger nella procedura guidata per la nuova sottoscrizione dell'hook di servizio. L'elenco degli eventi, due filtri e il pulsante Avanti sono evidenziati.

  5. Configurare l'azione da eseguire quando si verifica l'evento:

    • In Chiave API Datadog immettere la chiave API Datadog.

    • In Tipo di account Datadog selezionare il tipo di account. È possibile determinare il tipo di account dal nome host dell'URL usato dall'account Datadog.

      Hostname URL Tipo di conto
      app.datadoghq.com Stati Uniti
      app.datadoghq.eu UE
      us3.datadoghq.com US3
      us5.datadoghq.com US5
      ap1.datadoghq.com AP1
      app.dog-gov.com GOV

  6. Per verificare che Azure DevOps possa usare le impostazioni di configurazione e creare correttamente una sottoscrizione, selezionare Test.

  7. Per completare la creazione della sottoscrizione, selezionare Fine.

    Screenshot della pagina Azione nella procedura guidata Nuova sottoscrizione hook di servizio, con una chiave e un tipo di account visibile e Prova e Fine evidenziati.

Aggiungere sottoscrizioni per altri eventi

Ripetere i passaggi descritti in Creare una sottoscrizione per un evento per ogni tipo di evento da inviare a Datadog. Datadog accetta e incoraggia gli utenti a inviare tutti i tipi di evento.

Usare i dati in Datadog

Quando si verificano eventi e i relativi dati e metriche iniziano a fluire in Datadog, è possibile configurare dashboard e monitoraggi. Per iniziare, passare a Datadog.

Domande frequenti

D: È possibile creare sottoscrizioni hook del servizio a livello di codice?

R: Sì. Per altre informazioni, vedere Creare una sottoscrizione hook del servizio a livello di codice. Il tipo di account Datadog determina l'endpoint a cui la sottoscrizione deve inviare richieste. Usare uno degli endpoint seguenti:

Tipo di conto Punto finale
Stati Uniti https://app.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
UE https://app.datadoghq.eu/intake/webhook/azuredevops?api_key=<API-key>
US3 https://us3.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
US5 https://us5.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
AP1 https://ap1.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
Governo https://app.ddog-gov.com/intake/webhook/azuredevops?api_key=<API-key>

D: Come è possibile usare questi eventi in Datadog?

R: Gli eventi di Azure DevOps inviati a Datadog sono utili per la creazione di dashboard, la configurazione dei monitoraggi e la ricerca di correlazioni durante la risoluzione dei problemi. È anche possibile usare i dati degli eventi per ottenere informazioni dettagliate sul modo in cui i processi nelle operazioni di sviluppo influiscono sulle prestazioni dell'applicazione.

D: Quali tipi di evento è possibile inviare a Datadog?

R: Datadog accetta tutti i tipi di evento.

D: È possibile ottenere informazioni più generali su Datadog?

R: Sì, vedere datadoghq.com.