{"id":440,"date":"2018-04-17T10:43:40","date_gmt":"2018-04-17T13:43:40","guid":{"rendered":"http:\/\/docs.unitplatform.io\/?p=440"},"modified":"2019-01-10T11:36:01","modified_gmt":"2019-01-10T13:36:01","slug":"how-to-enable-telegram-notifications","status":"publish","type":"post","link":"https:\/\/docs.unitplatform.io\/en\/how-to-enable-telegram-notifications\/","title":{"rendered":"How to enable Telegram notifications","raw":"How to enable Telegram notifications"},"content":{"rendered":"<blockquote><p>If you haven&#8217;t configured Telegram yet, <a href=\"http:\/\/docs.unitplatform.io\/en\/how-to-configure-telegram-on-unit-platform\">read this post<\/a> first!<\/p><\/blockquote>\n<p>After configuring Telegram, you need to activate an action to send the notifications. Go to Multisite Monitoring and click on <strong>Activate actions<\/strong>:<\/p>\n<div id=\"attachment_444\" style=\"width: 274px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" aria-describedby=\"caption-attachment-444\" class=\"size-full wp-image-444\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-actions.png\" alt=\"\" width=\"264\" height=\"277\" \/><p id=\"caption-attachment-444\" class=\"wp-caption-text\">Activate actions menu<\/p><\/div>\n<p>Choose a status that you want to be notified about. For this example, we will configure notifications for cases where a service changes its status to CRITICAL. Click the add button on the right side:<\/p>\n<div id=\"attachment_445\" style=\"width: 543px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" aria-describedby=\"caption-attachment-445\" class=\"size-full wp-image-445\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/add-action.png\" alt=\"\" width=\"533\" height=\"277\" \/><p id=\"caption-attachment-445\" class=\"wp-caption-text\">Add action<\/p><\/div>\n<div id=\"attachment_446\" style=\"width: 606px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" aria-describedby=\"caption-attachment-446\" class=\"size-full wp-image-446\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-action2.png\" alt=\"\" width=\"596\" height=\"371\" \/><p id=\"caption-attachment-446\" class=\"wp-caption-text\">Activate action<\/p><\/div>\n<p>In this popup, select:<\/p>\n<ul>\n<li><strong>Action:<\/strong> Send Telegram notification.<\/li>\n<li><strong>Time interval:<\/strong> Full time.<\/li>\n<li><strong>Execute immediately:<\/strong> if you want to receive the messages immediately, choose &#8220;yes&#8221;. If not, you should specify the time, in minutes, that the system will wait before sending the messages (recommended: 5 minutes).<\/li>\n<li><strong>Execute only once:<\/strong> this option allows to configure recurrences. By choosing &#8220;no&#8221;, the system will resend the messages at the specified interval. Recommended: &#8220;yes&#8221; (send only once).<\/li>\n<li><strong>Apply to all devices and services:<\/strong> when choosing &#8220;yes&#8221;, notifications will be sent for all devices and services. If you need to enable a notification for specific devices and\/or services, choose &#8220;no&#8221; and select the specific items in the tabs &#8220;Devices&#8221; and &#8220;Services&#8221;.<\/li>\n<\/ul>\n<p>Click <strong>Finish<\/strong> to enable the action.<\/p>\n<h3>Usage cases<\/h3>\n<p>This system has the ability to cover the following usage examples:<\/p>\n<ul>\n<li>Send a message if a service is in ERROR status for more than 10 minutes.<\/li>\n<li>Send a message every 30 minutes if a service goes into CRITICAL and remains in this status.<\/li>\n<li>Send a message if a service is in CRITICAL status for 20 minutes. If the service continues in this status, repeat the message every 5 minutes.<\/li>\n<li>Send a message immediately after a service goes int CRITICAL status. If the service continues in this status, repeat message every 15 minutes.<\/li>\n<\/ul>\n<h3>Recommendations<\/h3>\n<ul>\n<li>Avoid creating various rules for the same status and same devices and\/or services with similar objectives. This can increase the volume of notifications, because every rule is processed independently from each other.<\/li>\n<li>For services that change status too frequently: choose &#8220;no&#8221; in the option &#8220;Execute immediately&#8221;, and specify a time delay, example: 5 minutes. This will make the system wait and send the messages only if the service remains in a problem status for the time specified.<\/li>\n<li>Configure recurrences only for specific services, otherwise the amount of messages sent will increase significantly.<\/li>\n<\/ul>\n","protected":false,"raw":"<blockquote>If you haven't configured Telegram yet, <a href=\"http:\/\/docs.unitplatform.io\/en\/how-to-configure-telegram-on-unit-platform\">read this post<\/a> first!<\/blockquote>\r\nAfter configuring Telegram, you need to activate an action to send the notifications. Go to Multisite Monitoring and click on <strong>Activate actions<\/strong>:\r\n\r\n[caption id=\"attachment_444\" align=\"alignnone\" width=\"264\"]<img class=\"size-full wp-image-444\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-actions.png\" alt=\"\" width=\"264\" height=\"277\" \/> Activate actions menu[\/caption]\r\n\r\nChoose a status that you want to be notified about. For this example, we will configure notifications for cases where a service changes its status to CRITICAL. Click the add button on the right side:\r\n\r\n[caption id=\"attachment_445\" align=\"alignnone\" width=\"533\"]<img class=\"size-full wp-image-445\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/add-action.png\" alt=\"\" width=\"533\" height=\"277\" \/> Add action[\/caption]\r\n\r\n[caption id=\"attachment_446\" align=\"alignnone\" width=\"596\"]<img class=\"size-full wp-image-446\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-action2.png\" alt=\"\" width=\"596\" height=\"371\" \/> Activate action[\/caption]\r\n\r\nIn this popup, select:\r\n<ul>\r\n \t<li><strong>Action:<\/strong> Send Telegram notification.<\/li>\r\n \t<li><strong>Time interval:<\/strong> Full time.<\/li>\r\n \t<li><strong>Execute immediately:<\/strong> if you want to receive the messages immediately, choose \"yes\". If not, you should specify the time, in minutes, that the system will wait before sending the messages (recommended: 5 minutes).<\/li>\r\n \t<li><strong>Execute only once:<\/strong> this option allows to configure recurrences. By choosing \"no\", the system will resend the messages at the specified interval. Recommended: \"yes\" (send only once).<\/li>\r\n \t<li><strong>Apply to all devices and services:<\/strong> when choosing \"yes\", notifications will be sent for all devices and services. If you need to enable a notification for specific devices and\/or services, choose \"no\" and select the specific items in the tabs \"Devices\" and \"Services\".<\/li>\r\n<\/ul>\r\nClick <strong>Finish<\/strong> to enable the action.\r\n<h3>Usage cases<\/h3>\r\nThis system has the ability to cover the following usage examples:\r\n<ul>\r\n \t<li>Send a message if a service is in ERROR status for more than 10 minutes.<\/li>\r\n \t<li>Send a message every 30 minutes if a service goes into CRITICAL and remains in this status.<\/li>\r\n \t<li>Send a message if a service is in CRITICAL status for 20 minutes. If the service continues in this status, repeat the message every 5 minutes.<\/li>\r\n \t<li>Send a message immediately after a service goes int CRITICAL status. If the service continues in this status, repeat message every 15 minutes.<\/li>\r\n<\/ul>\r\n<h3>Recommendations<\/h3>\r\n<ul>\r\n \t<li>Avoid creating various rules for the same status and same devices and\/or services with similar objectives. This can increase the volume of notifications, because every rule is processed independently from each other.<\/li>\r\n \t<li>For services that change status too frequently: choose \"no\" in the option \"Execute immediately\", and specify a time delay, example: 5 minutes. This will make the system wait and send the messages only if the service remains in a problem status for the time specified.<\/li>\r\n \t<li>Configure recurrences only for specific services, otherwise the amount of messages sent will increase significantly.<\/li>\r\n<\/ul>"},"excerpt":{"rendered":"<p>Enable notification messages using Telegram<\/p>\n","protected":false,"raw":"Enable notification messages using Telegram"},"author":3,"featured_media":1061,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_pt_post_content":"<blockquote>Caso voc\u00ea ainda n\u00e3o tenha configurado o Telegram, <a href=\"http:\/\/docs.unitplatform.io\/como-configurar-o-telegram-na-unit-platform\">veja este post<\/a> primeiro!<\/blockquote>\r\nAp\u00f3s a configura\u00e7\u00e3o do Telegram, \u00e9 necess\u00e1rio ativar uma a\u00e7\u00e3o de envio de notifica\u00e7\u00f5es. Para isso, acesse o Multisite Monitoring no menu <strong>Ativar a\u00e7\u00f5es<\/strong>:\r\n\r\n[caption id=\"attachment_444\" align=\"alignnone\" width=\"264\"]<img class=\"size-full wp-image-444\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-actions.png\" alt=\"\" width=\"264\" height=\"277\" \/> Menu Ativar a\u00e7\u00f5es[\/caption]\r\n\r\nNessa tela, escolha um estado para o qual voc\u00ea deseja habilitar o envio de notifica\u00e7\u00f5es. Para fins de exemplo, habilitaremos o envio de notifica\u00e7\u00f5es para os casos onde os servi\u00e7os entram no estado CRITICAL. Clique no bot\u00e3o de adicionar ao lado do nome do estado:\r\n\r\n[caption id=\"attachment_445\" align=\"alignnone\" width=\"533\"]<img class=\"size-full wp-image-445\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/add-action.png\" alt=\"\" width=\"533\" height=\"277\" \/> Adicionar a\u00e7\u00e3o[\/caption]\r\n\r\n[caption id=\"attachment_446\" align=\"alignnone\" width=\"596\"]<img class=\"size-full wp-image-446\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-action2.png\" alt=\"\" width=\"596\" height=\"371\" \/> Ativar a\u00e7\u00e3o[\/caption]\r\n\r\nNesta popup, selecione:\r\n<ul>\r\n \t<li><strong>A\u00e7\u00e3o:<\/strong> Send Telegram notification;<\/li>\r\n \t<li><strong>Per\u00edodo de tempo:<\/strong> Full time;<\/li>\r\n \t<li><strong>Executar imediatamente:<\/strong> caso voc\u00ea queira receber uma mensagem imediatamente, escolha \"sim\". Caso contr\u00e1rio, especifique o tempo em minutos no qual o sistema deve aguardar antes de disparar o envio (valor recomendado: 5 minutos);<\/li>\r\n \t<li><strong>Executar apenas uma vez:<\/strong> esta op\u00e7\u00e3o permite configurar recorr\u00eancia do envio da mesma mensagem (recomendado: \"sim\" -\u00a0 executar uma vez apenas);<\/li>\r\n \t<li><strong>Aplicar a todos os dispositivos e servi\u00e7os:<\/strong> escolhendo \"sim\", o envio de notifica\u00e7\u00f5es ser\u00e1 configurado para todos os dispositivos do sistema. Caso voc\u00ea deseje habilitar o envio de notifica\u00e7\u00f5es para apenas alguns dispositivos ou servi\u00e7os espec\u00edficos, escolha \"n\u00e3o\" e especifique os itens nas abas \"Dispositivos\" e \"Servi\u00e7os\" que ser\u00e3o exibidas.<\/li>\r\n<\/ul>\r\nPor fim, clique em <strong>Finalizar<\/strong>.\r\n<h3>Exemplos de uso<\/h3>\r\nEsse sistema de configura\u00e7\u00e3o de notifica\u00e7\u00f5es cobre os seguintes exemplos de uso:\r\n<ul>\r\n \t<li>Envie uma mensagem caso um servi\u00e7o esteja a mais de 10 minutos no estado ERROR.<\/li>\r\n \t<li>Envie uma mensagem a cada 30 minutos caso um servi\u00e7o entre no estado CRITICAL e permane\u00e7a neste estado.<\/li>\r\n \t<li>Envie uma mensagem caso um servi\u00e7o fique 20 minutos em CRITICAL. Caso o servi\u00e7o se mantenha nesse estado, continue enviando uma mensagem a cada 5 minutos.<\/li>\r\n \t<li>Envie uma mensagem assim que um determinado servi\u00e7o entrar em CRITICAL. Caso o servi\u00e7o se mantenha nesse estado, continue enviando uma mensagem a cada 15 minutos.<\/li>\r\n<\/ul>\r\n<h3>Recomenda\u00e7\u00f5es<\/h3>\r\n<ul>\r\n \t<li>Evite criar v\u00e1rias regras para o mesmo estado e para os mesmos dispositivos e\/ou servi\u00e7os com objetivos parecidos. Isso pode fazer com que a quantidade de mensagens enviadas aumente bastante, visto que cada regra de notifica\u00e7\u00e3o \u00e9 processada de forma independente.<\/li>\r\n \t<li>Para servi\u00e7os que costumam trocar de estado com muita frequ\u00eancia: marque \"n\u00e3o\" na op\u00e7\u00e3o \"Executar imediatamente\" e especifique um valor, por exemplo: 5 minutos, assim o sistema enviar\u00e1 as mensagens apenas se o servi\u00e7o permanecer por um determinado tempo em uma condi\u00e7\u00e3o de erro.<\/li>\r\n \t<li>Configure recorr\u00eancias apenas para servi\u00e7os espec\u00edficos, caso contr\u00e1rio a quantidade de notifica\u00e7\u00f5es enviadas aumentar\u00e1 significativamente.<\/li>\r\n<\/ul>","_pt_post_name":"como-habilitar-notificacoes-por-telegram","_pt_post_excerpt":"Habilitar o disparo de notifica\u00e7\u00f5es via Telegram","_pt_post_title":"Como habilitar notifica\u00e7\u00f5es por Telegram","_en_post_content":"<blockquote>If you haven't configured Telegram yet, <a href=\"http:\/\/docs.unitplatform.io\/en\/how-to-configure-telegram-on-unit-platform\">read this post<\/a> first!<\/blockquote>\r\nAfter configuring Telegram, you need to activate an action to send the notifications. Go to Multisite Monitoring and click on <strong>Activate actions<\/strong>:\r\n\r\n[caption id=\"attachment_444\" align=\"alignnone\" width=\"264\"]<img class=\"size-full wp-image-444\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-actions.png\" alt=\"\" width=\"264\" height=\"277\" \/> Activate actions menu[\/caption]\r\n\r\nChoose a status that you want to be notified about. For this example, we will configure notifications for cases where a service changes its status to CRITICAL. Click the add button on the right side:\r\n\r\n[caption id=\"attachment_445\" align=\"alignnone\" width=\"533\"]<img class=\"size-full wp-image-445\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/add-action.png\" alt=\"\" width=\"533\" height=\"277\" \/> Add action[\/caption]\r\n\r\n[caption id=\"attachment_446\" align=\"alignnone\" width=\"596\"]<img class=\"size-full wp-image-446\" src=\"http:\/\/docs.unitplatform.io\/wp-content\/uploads\/2018\/03\/activate-action2.png\" alt=\"\" width=\"596\" height=\"371\" \/> Activate action[\/caption]\r\n\r\nIn this popup, select:\r\n<ul>\r\n \t<li><strong>Action:<\/strong> Send Telegram notification.<\/li>\r\n \t<li><strong>Time interval:<\/strong> Full time.<\/li>\r\n \t<li><strong>Execute immediately:<\/strong> if you want to receive the messages immediately, choose \"yes\". If not, you should specify the time, in minutes, that the system will wait before sending the messages (recommended: 5 minutes).<\/li>\r\n \t<li><strong>Execute only once:<\/strong> this option allows to configure recurrences. By choosing \"no\", the system will resend the messages at the specified interval. Recommended: \"yes\" (send only once).<\/li>\r\n \t<li><strong>Apply to all devices and services:<\/strong> when choosing \"yes\", notifications will be sent for all devices and services. If you need to enable a notification for specific devices and\/or services, choose \"no\" and select the specific items in the tabs \"Devices\" and \"Services\".<\/li>\r\n<\/ul>\r\nClick <strong>Finish<\/strong> to enable the action.\r\n<h3>Usage cases<\/h3>\r\nThis system has the ability to cover the following usage examples:\r\n<ul>\r\n \t<li>Send a message if a service is in ERROR status for more than 10 minutes.<\/li>\r\n \t<li>Send a message every 30 minutes if a service goes into CRITICAL and remains in this status.<\/li>\r\n \t<li>Send a message if a service is in CRITICAL status for 20 minutes. If the service continues in this status, repeat the message every 5 minutes.<\/li>\r\n \t<li>Send a message immediately after a service goes int CRITICAL status. If the service continues in this status, repeat message every 15 minutes.<\/li>\r\n<\/ul>\r\n<h3>Recommendations<\/h3>\r\n<ul>\r\n \t<li>Avoid creating various rules for the same status and same devices and\/or services with similar objectives. This can increase the volume of notifications, because every rule is processed independently from each other.<\/li>\r\n \t<li>For services that change status too frequently: choose \"no\" in the option \"Execute immediately\", and specify a time delay, example: 5 minutes. This will make the system wait and send the messages only if the service remains in a problem status for the time specified.<\/li>\r\n \t<li>Configure recurrences only for specific services, otherwise the amount of messages sent will increase significantly.<\/li>\r\n<\/ul>","_en_post_name":"how-to-enable-telegram-notifications","_en_post_excerpt":"Enable notification messages using Telegram","_en_post_title":"How to enable Telegram notifications","edit_language":"en","footnotes":""},"categories":[1,10,4,9],"tags":[],"class_list":["post-440","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-monitoring","category-multisite-monitoring","category-tutorials","category-unit-platform-cloud"],"_links":{"self":[{"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/posts\/440","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/comments?post=440"}],"version-history":[{"count":14,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/posts\/440\/revisions"}],"predecessor-version":[{"id":1062,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/posts\/440\/revisions\/1062"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/media\/1061"}],"wp:attachment":[{"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/media?parent=440"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/categories?post=440"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.unitplatform.io\/en\/wp-json\/wp\/v2\/tags?post=440"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}