Conexión a PagerDuty

Introducción

Una conexión a PagerDuty, creada utilizando el conector de PagerDuty, establece acceso a PagerDuty. Una vez que se configura una conexión, puedes crear instancias de actividades de PagerDuty asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión a PagerDuty

Una nueva conexión a PagerDuty se crea utilizando el conector de PagerDuty desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión a PagerDuty existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión a PagerDuty

La interfaz de configuración de la conexión a PagerDuty depende de la opción de Autenticación que selecciones:

• Token de API: Autentica la conexión utilizando una clave de API.

• OAuth 2.0: Autentica la conexión utilizando una aplicación registrada de PagerDuty configurada con la funcionalidad de OAuth 2.0 con alcance (descrito en Requisitos previos).

API token

Cuando seleccionas API Token como el método de Autenticación, se presenta esta interfaz:

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de PagerDuty y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el endpoint de PagerDuty, que se refiere tanto a una conexión específica como a sus actividades.

• Autenticación: Selecciona API Token.

• Correo electrónico: Ingresa la dirección de correo electrónico asociada con la clave de API REST.

• API token: Ingresa la clave de API REST de PagerDuty. Para obtener información sobre las claves de API REST, consulta la documentación de PagerDuty.

• Usar proxy por endpoint: Al usar un agente privado, se puede seleccionar esta configuración para utilizar configuraciones de proxy de agente privado.

• Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por los agentes en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

OAuth 2.0

Cuando seleccionas OAuth 2.0 como el método de Autenticación, se presenta esta interfaz:

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de PagerDuty y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de PagerDuty, que se refiere tanto a una conexión específica como a sus actividades.

• Autenticación: Selecciona OAuth 2.0.

• Correo electrónico: Ingresa la dirección de correo electrónico asociada con la instancia de PagerDuty.

• Subdominio: Ingresa el subdominio de la cuenta para tu instancia de PagerDuty. Por ejemplo, si la URL de tu instancia es jbexample.pagerduty.com, ingresa jbexample.

• ID de cliente: Ingresa el ID de cliente emitido durante el registro de la aplicación (descrito en Requisitos previos).

• Secreto de cliente: Ingresa el secreto de cliente emitido durante el registro de la aplicación (descrito en Requisitos previos).

• Alcance: Ingrese el texto de Alcance de Permiso Seleccionado generado durante el registro de la aplicación (descrito en Requisitos previos).

• Región del servicio: Seleccione la región del servicio para la instancia de PagerDuty, ya sea EE. UU. (Estados Unidos) o UE (Europa).

• Usar proxy por endpoint: Al usar un agente privado, se puede seleccionar esta configuración para utilizar configuraciones de proxy de agente privado.

• Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

• Guardar Cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión de PagerDuty, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Obtener Incidente: Recupera un incidente de PagerDuty y está destinado a ser utilizado como fuente en una operación.

• Crear Incidente: Crea un incidente en PagerDuty y está destinado a ser utilizado como objetivo en una operación.

• Actualizar Incidente: Actualiza un incidente en PagerDuty y está destinado a ser utilizado como objetivo en una operación.

• Crear Nota: Crea una nota asociada con un incidente en PagerDuty y está destinado a ser utilizado como objetivo en una operación.

• Gestionar Incidentes: Actualiza múltiples incidentes en PagerDuty y está destinado a ser utilizado como objetivo en una operación.

• Listar Incidente: Recupera múltiples incidentes de PagerDuty y está destinado a ser utilizado como fuente en una operación.

• Crear Actualización de Estado: Crea una actualización de estado asociada con un incidente en PagerDuty y está destinado a ser utilizado como objetivo en una operación.

• Posponer Incidente: Pospone un incidente en PagerDuty y está destinado a ser utilizado como objetivo en una operación.