HowTo Parse or Capture xMatters Event ID from Integration Agent

Please sign in to leave a comment.

• 

  Travis Depuy

  Hi Aris!
  Sounds like you are having some fun with the IA! As of IA 5.1.5, all of the Integration Endpoints insert the request into a queue and run the code asynchronously. This helps with high availability so the agent doesn't get overwhelmed with requests while waiting on the code to complete. One option would be to make a web service call from within the apia_input function to the management system.
  However, if you wanted to downgrade, the apia_http method of the IA in 5.1.4 does not run asynchronously and you can craft the http response. I've only ever tried this with HTTP POST, but you might be able to do a GET. A good starter article for using the http endpoint (as opposed to the agent endpoint you are using above, which calls apia_input) is here.

  What are you looking to integrate to or why do you need the event ID on the response?

  Happy Tuesday!
  --- Travis

  January 27, 2016 17:15

  0
• 

  Jeremy Brown

  Aris, one way to do what you are asking about is to send the queryIncident request after submitting the incident. The returned information will include the eventID associated with the incident. However, you will have to find a way to cause a small delay between sending the incident and sending the queryIncident request (ie, to allow time for the event to be created by the xMatters server). One way to do this would be to invoke apclient.bin via a batch script, which would send the incident, wait a second or so, and then send the queryIncident request. I can provide some sample code to do these things. Let me know if you're interested in the specifics.

  January 27, 2016 18:56

  0
• 

  Aris Lawrence Sandiego

  Hi Guys, Thanks for the respone.

  Hi Travis,
  The reason why I need the Event ID is because that is the only accepted search parameter in xMatters SOAP (QueryEventAuditTrail).
  I have created a Web Site that displays the Event using SOAP but the only accepted search parameter is "eventIdentifier" which is the Event ID.

  Hi Jeremy,
  Looks like the method you are suggesting is a little complicated on my part because I don't know where to start.

  Another method I'm thinking is to call the external ".js" file to my Web Site.
  Is it possible to access the integration agent's ".js" through HTTP?

  An example is the Integration Agent "ping"
  I can see that there's a "ping.js" file and on that file, I can see "var id = apxml.getTransactionId();" and I can just call this variable if my Web Site can access the "ping.js" file like "http://server:port/integrationagent/ping/ping.js"

  January 28, 2016 07:32

  0
• 

  Jeremy Brown

  Aris, you asked "Is it possible to access the integration agent's ".js" through HTTP?" The answer is yes, you can put the code that you want to execute in a method called "apia_http" and then invoke it via an http post. The code can send a getIncident request to xMatters, parse the eventID out of the reply, and then return the eventID in the http response.

  You would just need to ensure that your application sends the http post a few seconds after the incident was created. This is necessary because the IA sends its messages to xMatters in batches, with 3-second intervals between the batches. It's possible to construct your code so that the incident creation message and the http request are enqueued together in the same batch, but much simpler to wait 3 seconds before you request the eventID via an http post.

  January 29, 2016 16:54

  0
• 

  Aris Lawrence Sandiego

  Thanks. I was busy with PHP, SOAP, LiveSearch and Migration from On-Prem to On-Demand.

  Travis, can you send me the HTTP Example for the IA file again? The compressed file that you have sent was empty. Thanks.

  February 03, 2016 14:28

  0
• 

  Travis Depuy

  Hey Aris,
  I did send it, but there was a .js and a .xml file, so maybe it got caught by your mail server. Anyway, I wrote up a full blog post about this here: https://support.xmatters.com/hc/en-us/articles/207883883
  The files are attached at the end.
  Let us know how it goes!
  --- Travis

  February 03, 2016 17:56

  0