In a previous article, we demonstrated how you could expose a trigger endpoint in Jira on a publicly accessible URL. You used this URL in Hybrid Cloud Console (HCC) to configure a webhook integration to forward Red Hat Insights events with the Notifications service. We cover Red Hat Insights integrations and the use of webhooks in another blog post.
To trigger something in Jira, though, you have to communicate with it. Red Hat Insights can send notifications to an endpoint, with useful data that you've configured Jira to use.
Webhook integration
First, create a new webhook integration by logging in to the Hybrid Cloud Console and navigating to Settings > Integrations. You must be an Organization Administrator or have Notifications Administrator permissions to edit these settings.
The screen groups all configurations related to other Red Hat products and third party applications integrations. You can find webhook integrations in the Webhooks tab.
![Webhooks configuration in Hybrid Cloud Console’s Settings](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image01.png.webp?itok=TbSeQ84d)
Webhooks configuration in Hybrid Cloud Console’s Settings
Click the Add integration button and follow the prompts. First, you must enter an integration name and an endpoint URL. In the endpoint URL field, enter the URL you created for the incoming webhook trigger. It follows this pattern (where <unique id> is specific to your trigger):
https://automation.atlassian.com/pro/hooks/ <unique id>
![Add integration wizard for webhooks in Hybrid Cloud Console’s Settings](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image02.png.webp?itok=z7GN0A5Q)
Add integration wizard for webhooks in Hybrid Cloud Console’s Settings
Leave the optional secret token field empty. It isn't used in this demonstration.
Click Next and Submit to create the integration endpoint for the Notifications service.
Set the destination for notifications
Now you must configure HCC so that every time Red Hat Insights events are triggered, each one is forwarded to the Jira Software integration you've created.
First, navigate to Settings > Notifications > Overview. The Overview screen describes the service and its functionality. It also guides you on getting started and configuring your organization for event notifications. All product documentation and guides are linked to this page.
Navigate to Notifications > Configure Events. Under the Red Hat Enterprise Linux tab, you can configure events and behavior groups. To forward Insights events, you first need to add your new integration to a behavior group in the Behavior Groups tab.
Depending on your own organization configuration, you may already have a behavior group you use for your notifications. You can either modify this behavior group, or create a new one specific to your Jira integration. For this example, edit your Default behavior group and add a new action by selecting Integration: Webhook as the action type, and JIRA (redhatinsights.atlassian.net) as recipient. The recipient name depends on the name you selected when configuring your new integration in Settings > Integrations.
![Edit behavior group notifications configuration in Red Hat Insights](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image03.png.webp?itok=Yf-9egU_)
Edit behavior group notifications configuration in Red Hat Insights
Next, you must associate event types from application services to your behavior group. When one of these events triggers, all actions from the behavior group occur, including forwarding the event to your Jira webhook integration.
On the Configure Events page that follows, navigate to the Configuration tab, confirm that the behavior group is now associated with the events you selected. You can modify this association at any time from this screen, or edit your behavior group to modify its event association.
![Configure Events and behavior groups association in Red Hat Insights](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image04.png.webp?itok=0J33YKoG)
Configure Events and behavior groups association in Red Hat Insights
From now on, all events triggered from a Red Hat Insights service are forwarded to your Jira Software incoming webhook endpoint for processing. The expected result based on your rule is the creation of an incident ticket in Jira with relevant data parsed from your event’s JSON payload.
Validate the webhook trigger integration between Hybrid Cloud Console and Jira Software
There are multiple ways to trigger Insights events, and we aren't covering them in this article. However, you can validate that an event is triggered successfully from HCC by navigating to Settings and selecting Notifications > Event Log.
The Event Log provides an audit trail of all events triggered by HCC in the past 14 days. You can filter the list by event type, application or service, action type (such as a webhook) and action status (successful or failure), or according to a specific time range.
The information on the Action taken column allows you to validate the behavior group’s actions when a particular event is triggered. In this example, you can click on Integration: Webhook for a given event to retrieve the name of the integration and its status.
You can see that the Insights event was successfully forwarded to the Jira endpoint:
![Successful webhook integration status in Event Log](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image05.png.webp?itok=TTKJZjr8)
Successful webhook integration status in Event Log
Troubleshooting a failed notification
In the case of a failure status, first validate that the URL endpoint is correct.
If the Jira integration is missing from events triggered after configuration, validate that the integration is part of a behavior group’s actions, and that the behavior group is associated with the event types you are expecting to be forwarded.
Refer to Red Hat Insights product documentation for more troubleshooting tips.
Verify ticket creation in Jira
Now that you've validated that the events are forwarded successfully to the Jira incoming webhook endpoint, navigate to Jira and verify that new tickets have been generated as a result.
In Jira, click All tickets in the project you selected during the Create incident component of the Rule builder. Look at the results to confirm that new tickets were created in response to Red Hat Insight's notifications.
![New tickets resulting from our integration in JIRA Software](/rhdc/managed-files/styles/wysiwyg_full_width/private/hybrid_cloud_console_jira_webhook_trigger_image06.png.webp?itok=muO0GZg_)
New tickets resulting from our integration in JIRA Software
The summary text of the new tickets is generated according to the syntax provided in the Create incident configuration. As you'd expect in Jira, you can open a ticket to view its full description, which was generated according to the syntax provided to parse your JSON payload.
Integration
This example is simple, but it provides a basis for receiving and parsing a JSON payload from Hybrid Cloud Console for Red Hat Insights events. You can extend this example to leverage additional automation based on the event’s fields or even the natural language processing (NLP) feature provided by Jira to automatically associate events from the same host or the same issue on the same ticket.
We're always looking for additional use cases, and welcome feedback to help the product grow. Let us know what integrations you would like to see, or vendors or communities we should collaborate with. Feel free to share your experience with us by using the Feedback form in Hybrid Cloud Console.
저자 소개
Jerome Marc is a Red Hat Sr. Principal Product Manager with over 15 years of international experience in the software industry spanning product management and product marketing, software lifecycle management, enterprise-level application design and delivery, and solution sales.
채널별 검색
오토메이션
기술, 팀, 인프라를 위한 IT 자동화 최신 동향
인공지능
고객이 어디서나 AI 워크로드를 실행할 수 있도록 지원하는 플랫폼 업데이트
오픈 하이브리드 클라우드
하이브리드 클라우드로 더욱 유연한 미래를 구축하는 방법을 알아보세요
보안
환경과 기술 전반에 걸쳐 리스크를 감소하는 방법에 대한 최신 정보
엣지 컴퓨팅
엣지에서의 운영을 단순화하는 플랫폼 업데이트
인프라
세계적으로 인정받은 기업용 Linux 플랫폼에 대한 최신 정보
애플리케이션
복잡한 애플리케이션에 대한 솔루션 더 보기
오리지널 쇼
엔터프라이즈 기술 분야의 제작자와 리더가 전하는 흥미로운 스토리
제품
- Red Hat Enterprise Linux
- Red Hat OpenShift Enterprise
- Red Hat Ansible Automation Platform
- 클라우드 서비스
- 모든 제품 보기
툴
체험, 구매 & 영업
커뮤니케이션
Red Hat 소개
Red Hat은 Linux, 클라우드, 컨테이너, 쿠버네티스 등을 포함한 글로벌 엔터프라이즈 오픈소스 솔루션 공급업체입니다. Red Hat은 코어 데이터센터에서 네트워크 엣지에 이르기까지 다양한 플랫폼과 환경에서 기업의 업무 편의성을 높여 주는 강화된 기능의 솔루션을 제공합니다.