jira ticket classification

Clasificación de tickets de Jira

Descripción general

Jira Ticket Classification es un sistema automatizado diseñado para clasificar los boletos de Jira utilizando las capacidades de inteligencia artificial de Amazon Bedrock. Este proyecto se puede utilizar con exportaciones de Jira Server, proporcionando capacidades de automatización similares a las disponibles en Jira Cloud.

Diagrama de arquitectura

Características

• Clasifica automáticamente los tickets de Jira según su contenido
• Utiliza Amazon Bedrock para la clasificación basada en IA
• Procesa las exportaciones de tickets de Jira colocadas en S3
• Utiliza AWS Glue para la deduplicación de datos
• Diseñado para funcionar con exportaciones de Jira Server

Nota : La deduplicación es importante si permite que los usuarios carguen manualmente exportaciones de Jira y también ejecuten la extracción automática. Si puede asegurarse de que ninguna importación incremental contenga duplicados, puede eliminar el trabajo de AWS Glue.

Cómo funciona

1. Entrada de datos : las exportaciones de tickets de Jira se colocan en la carpeta /unprocessed del depósito S3 implementado.

2. Procesamiento de datos : El sistema procesa los boletos exportados.

3. Clasificación de Bedrock : los datos de los boletos se envían a Amazon Bedrock, que utiliza un mensaje de clasificación predefinido para categorizar cada boleto.

4. Deduplicación : AWS Glue garantiza que no se procesen clasificaciones duplicadas, manteniendo la integridad de los datos.

5. Resultados : los resultados de la clasificación se almacenan y se pueden utilizar para actualizar los tickets originales de Jira o para realizar análisis adicionales.

Componentes

• Función Lambda : maneja la lógica principal para el procesamiento y clasificación de tickets.
• Amazon Bedrock : proporciona el modelo de IA para la clasificación de boletos.
• AWS Glue : gestiona la deduplicación de datos.
• S3 : almacena las exportaciones de Jira y los resultados de clasificación.
• Secrets Manager : almacena nuestra clave API de Jira, la URL base y la dirección de correo electrónico para obtener tickets de Jira.

Instalación y configuración

Aviso importante : este proyecto implementa recursos en su entorno de AWS utilizando Terraform. Incurrirá en costos por los recursos de AWS utilizados. Tenga en cuenta los precios de servicios como Lambda, Bedrock, Glue y S3 en su región de AWS.

Permisos requeridos : necesita permisos elevados, específicamente permisos de usuario avanzado, para implementar la pila Terraform.

Para configurar el proyecto:

1. Actualice la variable de entorno PROJECT_IDS_COMMA_SEPARATED de main.tf fetch_jira_issue_lambda para incluir los ID de proyecto que desea extraer
2. Navegue a la carpeta infrastructure en el proyecto.
3. Ejecute terraform init para inicializar el directorio de trabajo de Terraform.
4. Ejecute terraform apply para crear los recursos en su entorno de AWS.
5. Vaya al administrador de secretos y actualice el secreto de Jira con su configuración de Jira.

Para derribar el proyecto:

1. Navegue a la carpeta infrastructure .
2. Ejecute terraform destroy para eliminar todos los recursos creados por este proyecto.

Seguridad

Asegúrese de ejecutar tfsec en la carpeta de infraestructura cada vez que realice un cambio adicional en el código.

Ejecute TFSec

$ tfsec .

Advertencias suprimidas Asegúrese de ejecutar tfsec en la carpeta de infraestructura cada vez que realice un cambio adicional en el código. Estas advertencias de seguridad se han suprimido, pero revíselas antes de implementar esta solución en producción. Además, este repositorio de muestra utiliza claves administradas por AWS. Se recomienda utilizar claves administradas por el cliente (CMK) en un entorno de producción.

1. Secrets Manager "aws-ssm-secret-use-customer-key": esta advertencia requiere que usemos una clave KMS para nuestro secreto.
2. S3 "aws-s3-enable-bucket-logging": elimínelo y actívelo si el registro del depósito tiene sentido para su caso de uso
3. Cifrado de depósito S3 "aws_s3_bucket_server_side_encryption_configuration": estamos utilizando una clave de cifrado administrada por AWS
4. Lambda "aws-lambda-enable-tracing": active el seguimiento si tiene sentido para su proyecto.

Uso

1. Exporta tickets desde tu instancia de Jira Server.
2. Coloque los datos del ticket exportado en la carpeta /unprocessed del depósito S3 creado por el script Terraform.
3. El sistema procesará automáticamente los archivos nuevos en esta carpeta.
4. Recupere los resultados de clasificación de la ubicación de salida designada en S3.

Requisitos

• Cuenta de AWS con acceso a Lambda, Bedrock, Glue y S3
• Terraform instalado en su máquina local
• Permisos de usuario avanzado en su cuenta de AWS
• Capacidad para exportar tickets desde Jira Server (no se requiere instancia de Jira Server)

Contribuyendo

Se aceptan contribuciones para mejorar el proyecto. No dude en enviar solicitudes de extracción o problemas abiertos para analizar posibles mejoras.

Licencia

Este proyecto está bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

Para obtener soporte o informar problemas, abra un problema en el repositorio de GitHub del proyecto.