Saltar al contenido principal

AZURE_DEVOPS_EXTENSION_INSTALLATION

SYS_LOG: SERVICE_INTEGRATION_ONLINE

La Extensión Oficial de DevOps Monitor para Azure DevOps es el conector seguro que recopila y despacha las métricas de rendimiento de tus pipelines, cobertura de pruebas, duraciones de compilación y fallos de código de manera directa a la plataforma SaaS.

01_DOWNLOAD_AND_INSTALL​

Para habilitar el envío automático de telemetría, el administrador de Azure DevOps debe instalar el plugin en la organización de destino:

  1. Ingresa a la página oficial de la extensión en la Marketplace de Visual Studio: DevOps Monitor Task en el Visual Studio Marketplace.
  2. Haz clic en el botón Get it free.
  3. Selecciona tu organización de Azure DevOps para autorizar y completar la instalación de la extensión de inmediato.

02_SERVICE_CONNECTION_PROVISIONING​

La extensión requiere autenticación segura de 1px contra tu Workspace de DevOps Monitor mediante una Service Connection:

+----------------------+     Se autentica vía API Key     +-------------------------+
|  Azure DevOps Org    | -------------------------------> |  SaaS DevOps Monitor    |
|  (Service Connection)|                                  |  (Workspace Telemetry)  |
+----------------------+                                  +-------------------------+

Paso a Paso para la Configuración:​

  1. En tu panel de Azure DevOps, ingresa a Project Settings (esquina inferior izquierda).
  2. Selecciona la pestaña Service Connections bajo el canal de Pipelines.
  3. Haz clic en New service connection y selecciona el tipo DevOps Monitor Connection.
  4. Completa los parámetros técnicos requeridos:
    • Server URL: https://devsecops-monitor.newinntech.com/api
    • Workspace API Key: Pega tu API Key de integración generada desde la sección /dashboard/settings/apikey de tu SaaS.
    • Connection Name: Nombra la conexión como DevOpsMonitorConn para referenciarla en tus códigos.
  5. Haz clic en Save y otorga permisos de acceso a todos los pipelines de tu proyecto.

03_PIPELINE_YAML_INTEGRATION​

Una vez configurada la Service Connection, puedes inyectar la tarea analítica directamente en tu archivo de configuración de pipeline (azure-pipelines.yml) para sincronizar datos en cada compilación.

Ejemplo de Configuración YAML:​

Agrega el siguiente micro-bloque de código al final de la definición de tus pasos (steps) de compilación:

trigger:
  - main
  - develop

pool:
  vmImage: 'ubuntu-latest'

steps:
  - script: npm run build
    displayName: '[Build Front-end / Webpack Compile]'

  # --- INYECTAR TAREA DE DEVOPS MONITOR ---
  - task: DevOpsMonitorTask@1
    displayName: 'SYS_TELEMETRY Despachar Métricas a DevOps Monitor'
    condition: always() # Garantiza el despacho de logs incluso si la compilación de arriba falla
    inputs:
      connectionName: 'DevOpsMonitorConn'
      workspaceId: '1' # Reemplaza por tu ID de Workspace del SaaS
      projectName: '$(System.TeamProject)'
      repository: '$(Build.Repository.Name)'
      branch: '$(Build.SourceBranchName)'

04_TROUBLESHOOTING_ALERTS​

  • Permisos de Token: Si el pipeline arroja el código de error ERROR Unauthorized (401), verifica que la API Key en tu Service Connection de Azure DevOps no haya sido revocada o tenga cuotas mensuales excedidas.
  • Filtro de Ramas: Asegúrate de que las compilaciones de ramas temporales de desarrolladores (features/*) cuenten con acceso a la Service Connection si deseas monitorear sus heatmaps de fallas.