Export project logs in syslog format

[ramiuslr]

Would it be possible to export project logs to an external syslog server ?
That would be awesome to have the informations of the dashboard exported in a standard way.

I'm thinking of a field into project's settings to add a syslog server to forward to.

[fiftin]

Hi @ramiuslr
what logs go you mean?

[tboerger]

I think he's talking about the job output which is available on the ui/api only.

[ramiuslr]

Thanks for your quick replies ! Yes, I mean the logs we can get only via api/ui, about tasks executions.

[fiftin]

Hi @ramiuslr need examples, how it should works.

[ramiuslr]

Hi @fiftin, thanks for your interest !

Steps from user point of view would be:

• Configure a Syslog server in a dedicated field in the project's settings page:
  
  That would be something like Forward project history to Syslog: 192.168.1.50:514

• Once it is configured, each run of task in Semaphore would be forwarded to the Syslog server following a format like:

[isotimestamp-start] [task-id] [task-name] [status] [user] [isotimestamp-end]

Here is an example:

20210907T143000+0200 15 update-linux-servers success jdoe 20210907T143500+0200

Value	Meaning
Time start	ISO 8601 timestamp when the task starts
Task ID	The unique task ID we see in the dashboard history
Task name	The task name defined by the user when he creates the task
Task status	Should be Success / Failed
User	The user who runs the task
Time end	ISO 8601 timestamp when the task stops

I see only two triggers for generating Syslog entries for now:

• When a task starts
• When a task ends (whatever the exit status)

I'm not an expert in Syslog format, and what I'm proposing here probably needs to be discussed and improved (for example to ensure compatibility with RFC 5424 & 3164), but this is the basic idea.

Implementing this standard format would really be awesome, in order to have plain text logs, and to be able to parse these logs with a third party tool like Graylog or something else.

I hope these clarifications will help you.
Tell me if you need more informations, I remain at your disposal.

Thanks again !

[dderemiah]

Sending logs to syslog that show who did what would be extremely appreciated.