VhS%dddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z dZ edk(re yy) )absolute_importdivisionprint_functiona module: sensu_handler author: "David Moreau Simard (@dmsimard)" short_description: Manages Sensu handler configuration description: - Manages Sensu handler configuration. - 'For more information, refer to the L(Sensu documentation, https://sensuapp.org/docs/latest/reference/handlers.html).' deprecated: removed_in: 13.0.0 why: Sensu Core and Sensu Enterprise products have been End of Life since 2019/20. alternative: Use Sensu Go and its accompanying collection C(sensu.sensu_go). extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: state: type: str description: - Whether the handler should be present or not. choices: ['present', 'absent'] default: present name: type: str description: - A unique name for the handler. The name cannot contain special characters or spaces. required: true type: type: str description: - The handler type. choices: ['pipe', 'tcp', 'udp', 'transport', 'set'] filter: type: str description: - The Sensu event filter (name) to use when filtering events for the handler. filters: type: list elements: str description: - An array of Sensu event filters (names) to use when filtering events for the handler. - Each array item must be a string. severities: type: list elements: str description: - An array of check result severities the handler will handle. - 'NOTE: event resolution bypasses this filtering.' - "Example: [ 'warning', 'critical', 'unknown' ]." mutator: type: str description: - The Sensu event mutator (name) to use to mutate event data for the handler. timeout: type: int description: - The handler execution duration timeout in seconds (hard stop). - Only used by pipe and tcp handler types. default: 10 handle_silenced: description: - If events matching one or more silence entries should be handled. type: bool default: false handle_flapping: description: - If events in the flapping state should be handled. type: bool default: false command: type: str description: - The handler command to be executed. - The event data is passed to the process using STDIN. - 'NOTE: the O(command) attribute is only required for Pipe handlers (that is, handlers configured with O(type=pipe)).' socket: type: dict description: - The socket definition scope, used to configure the TCP/UDP handler socket. - 'NOTE: the O(socket) attribute is only required for TCP/UDP handlers (that is, handlers configured with O(type=tcp) or O(type=udp)).' pipe: type: dict description: - The pipe definition scope, used to configure the Sensu transport pipe. - 'NOTE: the O(pipe) attribute is only required for Transport handlers (that is, handlers configured with O(type=transport)).' handlers: type: list elements: str description: - An array of Sensu event handlers (names) to use for events using the handler set. - 'NOTE: the O(handlers) attribute is only required for handler sets (that is, handlers configured with O(type=set)).' a # Configure a handler that sends event data as STDIN (pipe) - name: Configure IRC Sensu handler community.general.sensu_handler: name: "irc_handler" type: "pipe" command: "/usr/local/bin/notify-irc.sh" severities: - "ok" - "critical" - "warning" - "unknown" timeout: 15 notify: - Restart sensu-client - Restart sensu-server # Delete a handler - name: Delete IRC Sensu handler community.general.sensu_handler: name: "irc_handler" state: "absent" # Example of a TCP handler - name: Configure TCP Sensu handler community.general.sensu_handler: name: "tcp_handler" type: "tcp" timeout: 30 socket: host: "10.0.1.99" port: 4444 register: handler notify: - Restart sensu-client - Restart sensu-server - name: Secure Sensu handler configuration file ansible.builtin.file: path: "{{ handler['file'] }}" owner: "sensu" group: "sensu" mode: "0600" a config: description: Effective handler configuration, when state is present. returned: success type: dict sample: {'name': 'irc', 'type': 'pipe', 'command': '/usr/local/bin/notify-irc.sh'} file: description: Path to the handler configuration file. returned: success type: str sample: "/etc/sensu/conf.d/handlers/irc.json" name: description: Name of the handler. returned: success type: str sample: "irc" N) AnsibleModulectdttdddgdtddtdgdtd td d td d td td d tddtddtd td td td d dddggdddggdddggdddggdddggdddggg}|jd}|jd}dj|}|dk(rtj j |rn|jr&d j|!}|j|d"n` t j|d#j|!}|j|d"n$d'j|!}|j|&d|iii}gd(}|D]9}||jvs|j|"|j||d||<;d} tjt|d)} | | |k(r|jd*|d|||+|jsotj j tj j%|s3 t j&tj j%||jr|jd-d|d|||. t|d/5} | j)tj*|d01|jd2d|d|||.dddy#t$r9}d$}|j|j|t|%&Yd}~d}~wwxYw#t t"f$rYuwxYw#t$rS}|jd,jtj j%|t|&Yd}~3d}~wwxYw#1swYyxYw#tt f$r5}|jd3j|t|&Yd}~yd}~wwxYw)4NTstrpresentabsent)typechoicesdefault)r required)pipetcpudp transportset)r r )r list)r elementsint )r r boolFdict)statenamer filterfilters severitiesmutatortimeouthandle_silencedhandle_flappingcommandsocketrhandlersrr rr#rr$rrrr%)supports_check_mode argument_spec required_ifrz#/etc/sensu/conf.d/handlers/{0}.jsonz{path} would have been deleted)path)msgchangedz{path} deleted successfullyz3Exception when trying to delete {path}: {exception})r) exception)r*z{path} already does not exist) r rrrrr r!r"r#r$rr%rz+Handler configuration is already up to date)r*configfilerzUnable to create {0}: {1}z-Handler configuration would have been updated)r*r+r.r/rw)indentzHandler configuration updatedzUnable to write file {0}: {1})rrparamsformatosr)exists check_mode exit_jsonremoveOSError fail_jsonrjsonloadopenIOError ValueErrordirnamemakedirswritedumps) modulerrr)r*er.argsargcurrent_confighandlers s/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/sensu_handler.pymainrLs]  EIx+@)T5405*TUU#fu5%8e$eR0 fe< fe<e$V$6"v6 "i& * Vi[ ) UXJ ' UXJ ' [6( + UZL )  %F8 MM' "E == D 0 7 7 =D  77>>$   6==4=H  S$ 7EIIdO7>>D>IC$$d$;288d8CC     %4* %F D? &-- FMM#$6$B,2MM#,>F: t $S )? N 4c?3 !n&>J &z 24 8""  $   RWW^^BGGOOD4I%J M KK- . L!% &z 24 8""  $ M $_ ( MM$**VA6 7   !@%)$*:$6t$<"&"&  ( ( (eEOC$$JJDCFJC%EEE. Z     M   !rWsRA@ _ B+ Z $ 4fMR zFrV