https://docs.logz.io/assets/js/d9ab64db.74fbe750.js

1"use strict";(self.webpackChunkmy_website=self.webpackChunkmy_website||[]).push([[702],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>m});var i=n(67294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function r(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,i,o=function(e,t){if(null==e)return{};var n,i,o={},a=Object.keys(e);for(i=0;i<a.length;i++)n=a[i],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(i=0;i<a.length;i++)n=a[i],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=i.createContext({}),c=function(e){var t=i.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):r(r({},t),e)),n},p=function(e){var t=c(e.components);return i.createElement(l.Provider,{value:t},e.children)},g="mdxType",u={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),g=c(n),d=o,m=g["".concat(l,".").concat(d)]||g[d]||u[d]||a;return n?i.createElement(m,r(r({ref:t},p),{},{components:n})):i.createElement(m,r({ref:t},p))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,r=new Array(a);r[0]=d;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s[g]="string"==typeof e?e:o,r[1]=s;for(var c=2;c<a;c++)r[c]=n[c];return i.createElement.apply(null,r)}return i.createElement.apply(null,n)}d.displayName="MDXCreateElement"},85757:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>u,frontMatter:()=>a,metadata:()=>s,toc:()=>c});var i=n(87462),o=(n(67294),n(3905));const a={sidebar_position:2,title:"PagerDuty Endpoint Configuration",description:"Integrate Logz.io with PagerDuty to trigger real-time incidents from alerts.",image:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/social-assets/docs-social.jpg",ke

1ywords:["logz.io","pagerduty","pagerduty integration","incident management","alerting","logz.io alerts","real-time alerts","observability","notification endpoint","incident automation","logz.io setup","pagerduty setup","monitoring integration"]},r=void 0,s={unversionedId:"user-guide/integrations/notification-endpoints/pagerduty",id:"user-guide/integrations/notification-endpoints/pagerduty",title:"PagerDuty Endpoint Configuration",description:"Integrate Logz.io with PagerDuty to trigger real-time incidents from alerts.",source:"@site/docs/user-guide/integrations/notification-endpoints/pagerduty.md",sourceDirName:"user-guide/integrations/notification-endpoints",slug:"/user-guide/integrations/notification-endpoints/pagerduty",permalink:"/docs/user-guide/integrations/notification-endpoints/pagerduty",draft:!1,editUrl:"https://github.com/logzio/documentation/tree/master/docs/user-guide/integrations/notification-endpoints/pagerduty.md",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2,title:"PagerDuty Endpoint Configuration",description:"Integrate Logz.io with PagerDuty to trigger real-time incidents from alerts.",image:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/social-assets/docs-social.jpg",ke

1ywords:["logz.io","pagerduty","pagerduty integration","incident management","alerting","logz.io alerts","real-time alerts","observability","notification endpoint","incident automation","logz.io setup","pagerduty setup","monitoring integration"]},sidebar:"tutorialSidebar",previous:{title:"Notification Endpoints",permalink:"/docs/user-guide/integrations/notification-endpoints/endpoints"},next:{title:"ServiceNow Endpoint Configuration",permalink:"/docs/user-guide/integrations/notification-endpoints/servicenow"}},l={},c=[{value:"Prerequisites",id:"prerequisites",level:2},{value:"Step 1: Configure PagerDuty",id:"step-1-configure-pagerduty",level:2},{value:"Option A: Create a new service",id:"option-a-create-a-new-service",level:3},{value:"Option B: Add Logz.io to an existing service",id:"option-b-add-logzio-to-an-existing-service",level:3},{value:"Step 2: Create a PagerDuty endpoint in Logz.io",id:"step-2-create-a-pagerduty-endpoint-in-logzio",level:2},{value:"Step 3: Attach the endpoint to a Logz.io alert",id:"step-3-attach-the-endpoint-to-a-logzio-alert",level:2},{value:"PagerDuty integration with Logz.io's RCA capabilities",id:"pagerduty-integration-with-logzios-rca-capabilities",level:2},{value:"How it works",id:"how-it-works",level:3},{value:"Troubleshooting",id:"troubleshooting",level:2},{value:"No incident is created in PagerDuty?",id:"no-incident-is-created-in-pagerduty",level:3},{value:"Can\u2019t find Logz.io in the integration list?",id:"cant-find-logzio-in-the-integration-list",level:3}],p={toc:c},g="wrapper";

1function u(e){let{components:t,...n}=e;return(0,o.kt)(g,(0,i.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("p",null,"Logz.io is an AI-powered observability platform that helps teams monitor, troubleshoot, and secure their applications using logs, metrics, and traces. It also offers GenAI-driven features to enhance observability workflows."),(0,o.kt)("p",null,"Logz.io integrates with PagerDuty to automatically create incidents from Logz.io alerts. This ensures on-call teams receive real-time notifications and can respond quickly, based on PagerDuty service configurations."),(0,o.kt)("p",null,"Beyond basic alerting, this integration also supports AI-driven Root Cause Analysis (RCA). Incidents in PagerDuty can trigger Logz.io\u2019s RCA Agent, which analyzes observability data (logs, metrics, traces, deployments) and enriches incidents with contextual insights and recommended fixes."),(0,o.kt)("h2",{id:"prerequisites"},"Prerequisites"),(0,o.kt)("p",null,"Before you begin you\u2019ll need:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Logz.io access with Admin role"),(0,o.kt)("li",{parentName:"ul"},"PagerDuty access with Admin permissions"),(0,o.kt)("li",{parentName:"ul"},"A new or existing PagerDuty service")),(0,o.kt)("h2",{id:"step-1-configure-pagerduty"},"Step 1: Configure PagerDuty"),(0,o.kt)("p",null,"You can connect Logz.io to a new or existing service in PagerDuty."),(0,o.kt)("h3",{id:"option-a-create-a-new-service"},"Option A: Create a new service"),(0,o.kt)("p",null,"In PagerDuty, navigate to ",(0,o.kt)("strong",{parentName:"p"},"Services > Service Directory")," and click ",(0,o.kt)("strong",{parentName:"p"},"+New Service"),". Give your service a name, choose whether to create a new escalation policy or use an existing one, and configure alert grouping if needed. "),(0,o.kt)("p",null,"In the ",(0,o.kt)("strong",{parentName:"p"},"Integrations")," section, select ",(0,o.kt)("strong",{parentName:"p"},"Logz.io")," from the list and complete the setup."),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/pagerduty-create-a-service.png",alt:"PagerDuty create a service"})),(0,o.kt)("p",null,"After saving, you\u2019ll be redirected to the service\u2019s Integrations page. Copy the generated ",(0,o.kt)("strong",{parentName:"p"},"Integration Key"),"."),(0,o.kt)("h3",{id:"option-b-add-logzio-to-an-existing-service"},"Option B: Add Logz.io to an existing service"),(0,o.kt)("p",null,"In the ",(0,o.kt)("strong",{parentName:"p"},"Service Directory"),", click the name of the service you'd like to update. Go to the ",(0,o.kt)("strong",{parentName:"p"},"Integrations tab")," and click ",(0,o.kt)("strong",{parentName:"p"},"Add a new integration"),"."),(0,o.kt)("p",null,"Select ",(0,o.kt)("strong",{parentName:"p"},"Logz.io")," from the integration list and click ",(0,o.kt)("strong",{parentName:"p"},"Add"),". After saving, you\u2019ll be redirected to the Integrations page. Copy the generated ",(0,o.kt)("strong",{parentName:"p"},"Integration Key"),"."),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/pagerduty-key.png",alt:"PagerDuty key"})),(0,o.kt)("h2",{id:"step-2-create-a-pagerduty-endpoint-in-logzio"},"Step 2: Create a PagerDuty endpoint in Logz.io"),(0,o.kt)("p",null,"In your ",(0,o.kt)("strong",{parentName:"p"},"Logz.io account"),", go to ",(0,o.kt)("strong",{parentName:"p"},"Settings > Notification Endpoints")," and click ",(0,o.kt)("strong",{parentName:"p"},"+ Add Endpoint"),". "),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/notification-endpoints.png",alt:"Notification endpoints"})),(0,o.kt)("p",null,"Choose ",(0,o.kt)("strong",{parentName:"p"},"PagerDuty")," as the endpoint type. Enter a name and optional description, then paste the ",(0,o.kt)("strong",{parentName:"p"},"Integration Key")," copied from PagerDuty. "),(0,o.kt)("p",null,"Click ",(0,o.kt)("strong",{parentName:"p"},"Run the test")," to verify that Logz.io can send data to PagerDuty successfully."),(0,o.kt)("p",null,"Click ",(0,o.kt)("strong",{parentName:"p"},"Add a new endpoint")," to save."),(0,o.kt)("admonition",{type:"note"},(0,o.kt)("p",{parentName:"admonition"},"You can create multiple Logz.io integrations in PagerDuty by adding them to new or existing services. Each integration generates a unique key that can be used to create a separate notification endpoint in Logz.io.")),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/add-an-endpoint-pager.png",alt:"Add a new endpoint"})),(0,o.kt)("h2",{id:"step-3-attach-the-endpoint-to-a-logzio-alert"},"Step 3: Attach the endpoint to a Logz.io alert"),(0,o.kt)("p",null,"In ",(0,o.kt)("strong",{parentName:"p"},"Logz.io"),", navigate to the ",(0,o.kt)("strong",{parentName:"p"},"Alerts page"),". Select an existing alert or create a new one. "),(0,o.kt)("p",null,"In the ",(0,o.kt)("strong",{parentName:"p"},"Select notification recipients")," section, choose the ",(0,o.kt)("strong",{parentName:"p"},"PagerDuty")," endpoint you created. "),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/choose-pagerduty-from-list.png",alt:"Select PagerDuty endpoints"})),(0,o.kt)("p",null,"When triggered, the alert sends a notification to PagerDuty, which generates a new incident based on your service settings."),(0,o.kt)("h2",{id:"pagerduty-integration-with-logzios-rca-capabilities"},"PagerDuty integration with Logz.io's RCA capabilities"),(0,o.kt)("p",null,"PagerDuty incidents can automatically trigger Logz.io\u2019s Root Cause Analyzer (RCA), triggering an automatic analysis and sending findings back to PagerDuty."),(0,o.kt)("h3",{id:"how-it-works"},"How it works"),(0,o.kt)("p",null,"When an alert in Logz.io fires, a PagerDuty incident is created. PagerDuty\u2019s automation agent immediately handles the initial triage by opening communication channels and, if configured, updating the status page."),(0,o.kt)("p",null,"Once the incident is active, PagerDuty enriches it with context from similar past incidents. This includes historical timelines, successful remediation steps, and information about who resolved comparable issues."),(0,o.kt)("p",null,"Logz.io\u2019s RCA Agent then runs a deep analysis of the real-time logs, metrics, and traces, combining this data with the enriched incident context. The output is a recommended fix or next step tailored to the current problem."),(0,o.kt)("p",null,"For low-risk issues, the RCA Agent can attempt an automatic remediation, such as restarting a service. If remediation is not safe or fails, PagerDuty escalates the incident to a human responder, who receives the RCA summary and recommended fix."),

1(0,o.kt)("p",null,"Finally, once the incident is resolved, PagerDuty updates stakeholders, records the RCA findings, and stores them for future reference. The next time a similar incident occurs, PagerDuty can surface these previous learnings to reduce resolution time even further."),(0,o.kt)("p",null,"Read more about Logz.io's ",(0,o.kt)("a",{parentName:"p",href:"https://docs.logz.io/docs/user-guide/observability/assistantiq/#ai-agent-root-cause-analyzer"},"AI Agent Root Cause Analyzer"),"."),(0,o.kt)("p",null,(0,o.kt)("img",{parentName:"p",src:"https://dytvr9ot2sszz.cloudfront.net/logz-docs/notification-endpoints/pagerrca.png",alt:"Pagerduty Logz.io RCA"})),(0,o.kt)("h2",{id:"troubleshooting"},"Troubleshooting"),(0,o.kt)("h3",{id:"no-incident-is-created-in-pagerduty"},"No incident is created in PagerDuty?"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Check that the alert is active."),(0,o.kt)("li",{parentName:"ul"},"Verify the Service Key (Integration Key) is correct."),(0,o.kt)("li",{parentName:"ul"},"Ensure the endpoint is connected to the correct alert."),(0,o.kt)("li",{parentName:"ul"},"Use the Run Test feature to confirm connectivity.")),(0,o.kt)("h3",{id:"cant-find-logzio-in-the-integration-list"},"Can\u2019t find Logz.io in the integration list?"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Confirm your PagerDuty plan supports custom integrations."),(0,o.kt)("li",{parentName:"ul"},"Ensure you have the necessary account permissions.")),(0,o.kt)("p",null,"If you have questions or run into issues while setting up the integration, contact ",(0,o.kt)("a",{parentName:"p",href:"mailto:[email protected]"},"Logz.io Support"),"."))}u.isMDXComponent=!0}}]);