A newer version of this documentation is available.
View Latest (v2.0)

Alerting

Gluesync natively supports sending alerts via email. The severity of the alerts caught during the process will only be error. This process can be customized by tweaking the alerting configuration file according to the logback’s framework documentation available at: http://logback.qos.ch/documentation.html.

To provide Gluesync with a custom Logback configuration file, you need to set the actual file path into an environment variable called LOG_CONFIG_FILE. Once set, Gluesync will override its default log settings and use the provided ones.

The standard configuration setting is explained here below that uses, for example, a Gmail SMTP server for sending email alerts:

<appender name="EMAIL" class="ch.qos.logback.classic.net.SMTPAppender">
   <smtpHost>smtp.gmail.com</smtpHost>
   <smtpPort>587</smtpPort>
   <STARTTLS>true</STARTTLS>
   <username>myusername@mycompany.com</username>
   <password>mysecretpassword</password>
   <asynchronousSending>true</asynchronousSending>
   <to>receiveremailaddress@mydomainname.com</to>
   <from>mysenderemailaddress@mydomainname.com</from>
   <subject>Gluesync SQL-to-NoSQL: %c{1} - %msg</subject>
   <layout class="ch.qos.logback.classic.html.HTMLLayout"/>
   <cyclicBufferTracker class="ch.qos.logback.core.spi.CyclicBufferTracker">
       <!-- send just one log entry per email -->
       <bufferSize>1</bufferSize>
   </cyclicBufferTracker>
</appender>
the larger the buffer size the more information your alert email will have inside respect to the previous error attempt.

Be sure to add the new appender reference inside the XML node logger section for the severity needed as described below.

<logger name="com.gluesync" level="error" additivity="false">
       <appender-ref ref="EMAIL"/>
</logger>