Enable SimpCon Push JSON Producer
overview the simpcon push json producer extension template provides a framework for developing extensions that receive json formatted records from an external source system and publish the records to a kafka topic through data streaming services the extension requires details about the external source system, including the system url and authentication credentials optional filters, such as assignment groups and domain separated company names, can restrict the records processed by the extension platform service interactions the extension transforms incoming requests and forwards them to the following data streaming service topic itil xxxxx source configure the extension the following environment variables must be passed to the container variable default comments dx ext extension user (string) mandatory bridge username used for basic authentication dx ext extension pw (string) mandatory bridge password used for basic authentication dx ext source query url (string) mandatory smt url to query for ticket state dx ext source user (string) mandatory smt username used for basic authentication dx ext source pw (string) mandatory smt password used for basic authentication dx env environment (string) mandatory the type of environment the extension is running in local, dev, or prod dx env ou key (string) mandatory ou tenant key dx env ou bac id (string) mandatory bac id of the client dx env ou es instance (string) mandatory the elasticearch instance the messages are supposed to go to on the consumer side dx ext cdi tool source (string) mandatory client tool mapping value dx ext cdi customercode (string) mandatory client tool mapping value how the extension works the application is a simplified connector producer designed to run as an extension instance in the integrated aiops platform the extension performs the following actions receives records in json format from an external source system transforms the incoming requests publishes the transformed records to a data streaming service kafka topic the extension runs as a container in a kubernetes environment deploy the extension deploy and configure the extension through the integrated aiops user interface the extension supports deployment to individual ous and compute zones within the platform local execution is intended only for developers who are familiar with the extension codebase run the extension locally build the container image open a terminal go to the extension directory cd \<extension path> build the docker image docker build t simpcon push producer 1 0 0 f /deployment/dockerfile start the container run the following command and replace the placeholder values with the appropriate configuration docker run rm \\ \ network host \\ itd \\ p 8080 8080 \\ e dx ext extension user=\<bridge username> \\ e dx ext extension pw=\<bridge password> \\ e dx ext source query url= https //kyndryleudev service now\ com/api/now/table/incident https //kyndryleudev service now\ com/api/now/table/incident \\ e dx ext source user=\<source username> \\ e dx ext source pw=\<source password> \\ e dx env environment=local \\ e dx env ou key=098a759b1e7c 1 \\ e dx env ou bac id=bac0000bf2 \\ e dx env ou es instance=es was1 \\ e dx ext cdi tool source=snow extsvc \\ e dx ext cdi customercode=id1 \\ simpcon push producer 1 0 0 monitor the container view running containers docker ps view the container logs docker logs \<container id> | less troubleshoot the container identify the container id docker ps open a shell session in the container docker exec it \<container id> /bin/bash support the extensions development team owns and maintains this extension