SMTP-beállítások konfigurálása

Ebben az útmutatóban megtudhatja, hogyan konfigurálhatja az SMTP-beállításokat az e-mail-riasztások Azure Managed Grafana-ban való létrehozásához. Az értesítések figyelmeztetik a felhasználókat, ha bizonyos forgatókönyvek egy Grafana-irányítópulton fordulnak elő.

Az SMTP-beállítások egy meglévő Felügyelt Grafana-példányon engedélyezhetők az Azure Portalon és az Azure CLI-n keresztül. Az SMTP-beállítások engedélyezése új példány létrehozásakor jelenleg nem támogatott.

Előfeltételek

Az útmutató lépéseinek követéséhez a következőket kell tennie:

• Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
• Egy Azure Managed Grafana-példány a Standard csomagban. Ha még nem rendelkezik ilyennel, hozzon létre egy új példányt.
• SMTP-kiszolgáló. Ha még nem rendelkezik ilyennel, érdemes megfontolnia a Twilio SendGrid e-mail API-jának használatát az Azure-hoz.

SMTP-beállítások engedélyezése és konfigurálása

Kövesse az alábbi lépéseket az SMTP-beállítások aktiválásához, az e-mail-értesítések engedélyezéséhez és egy e-mail-kapcsolattartási pont konfigurálásához az Azure Managed Grafana szolgáltatásban.

Portal

1. Az Azure Portalon nyissa meg a Grafana-példányt, és a Gépház alatt válassza a Konfiguráció lehetőséget.

2. Válassza az E-mail Gépház lapot.

3. Kapcsolja be az SMTP-Gépház, hogy megjelenjen az Engedélyezés funkció.

4. Megjelennek az SMTP-beállítások. Töltse ki az űrlapot a következő konfigurációval:

   Paraméter	Példa	Leírás
   Gazdagép	test.sendgrid.net:587	Adja meg az SMTP-kiszolgáló állomásnevét porttal.
   User	felügyelet	Adja meg az SMTP-hitelesítés felhasználójának nevét.
   Jelszó	jelszó	Adja meg az SMTP-hitelesítés jelszavát. Ha a jelszó "#" vagy ";" szöveget tartalmaz, csomagolja be három idézőjelbe.
   Feladó címe	user@domain.com	Adja meg az e-mailek küldésekor használt e-mail-címet.
   Feladó neve	Azure Managed Grafana Notification	Adja meg az e-mailek küldésekor használt nevet. Az alapértelmezett érték az "Azure Managed Grafana Notification" (Azure Managed Grafana Notification), ha a paraméter nincs megadva vagy üres.
   Ellenőrzés kihagyása	Letiltás	Ez a beállítás azt szabályozza, hogy egy ügyfél ellenőrzi-e a kiszolgáló tanúsítványláncát és állomásnevét. Ha az Ellenőrzés kihagyása engedélyezve van, az ügyfél elfogadja a kiszolgáló által bemutatott összes tanúsítványt és a tanúsítványban szereplő gazdagépnevet. Ebben a módban a TLS érzékeny a középső gépi támadásokra, kivéve, ha egyéni ellenőrzést használ. Az alapértelmezett beállítás a Letiltás (kikapcsolva). További információ.
   StartTLS-szabályzat	OpportunisticStartTLS	Három lehetőség közül választhat. További információ. Az OpportunisticStartTLS azt jelenti, hogy az SMTP-tranzakciók titkosítva vannak, ha a STARTTLS-t az SMTP-kiszolgáló támogatja. Ellenkező esetben az üzeneteket a rendszer üresen küldi el. Ez az alapértelmezett beállítás. A MandatoryStartTLS azt jelenti, hogy az SMTP-tranzakciókat titkosítani kell. Az SMTP-tranzakciók megszakadnak, hacsak az SMTP-kiszolgáló nem támogatja a STARTTLS-t. A NoStartTLS azt jelenti, hogy a titkosítás le van tiltva, és az üzeneteket a rendszer törli.

5. Az SMTP-beállítások mentéséhez válassza a Mentés lehetőséget. A frissítés eltarthat néhány percig.

   

6. Miután a folyamat befejeződött, a "A kijelölések frissítése" üzenet. A sikeres frissítés" az Azure-értesítésekben jelenik meg. Az Áttekintés lapon a példány kiépítési állapota frissítésre vált, majd a frissítés befejezése után sikeres lesz.

Azure CLI

1. Az SMTP-beállítások engedélyezéséhez vagy frissítéséhez az Azure Managed Grafana CLI 1.1-s vagy újabb bővítménye szükséges. A bővítmény frissítéséhez futtassa a következőt az extension update --name amg: .

2. Futtassa az az grafana update parancsot egy adott Azure Managed Grafana-példány SMTP-beállításainak konfigurálásához. Cserélje le a helyőrzőket a saját példány adataira.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp enabled \
       --from-address <from-address> \
       --from-name <from-name> \
       --host "<host>" \
       --user <user> \
       --password "<password>" \
       --start-tls-policy <start-TLS-policy> \
       --skip-verify <true-or-false> \
   

   Paraméter	Példa	Leírás
   --resource-group	my-resource-group	Adja meg az Azure Managed Grafana-példány erőforráscsoportjának nevét.
   --name	my-azure-managed-grafana	Adja meg az Azure Managed Grafana-példány nevét.
   --smtp	engedélyezve	Adja meg az SMTP-beállítások letiltásához engedélyezett értéket.
   --from-address	user@domain.com	Adja meg az e-mailek küldésekor használt e-mail-címet.
   --from-name	Azure Managed Grafana Notification	Adja meg az e-mailek küldésekor használt nevet. Az alapértelmezett érték az "Azure Managed Grafana Notification" (Azure Managed Grafana Notification), ha a paraméter nincs megadva vagy üres.
   --host	test.sendgrid.net:587	Adja meg az SMTP-kiszolgáló állomásnevét porttal.
   --user	felügyelet	Adja meg az SMTP-hitelesítés felhasználójának nevét.
   --password	jelszó	Adja meg az SMTP-hitelesítés jelszavát. Ha a jelszó "#" vagy ";" szöveget tartalmaz, csomagolja be három idézőjelbe.
   --start-tls-policy	OpportunisticStartTLS	Az SMTP-konfiguráció StartTLSPolicy beállítása. Három lehetőség közül választhat. További információ. Az OpportunisticStartTLS azt jelenti, hogy az SMTP-tranzakciók titkosítva vannak, ha a STARTTLS-t az SMTP-kiszolgáló támogatja. Ellenkező esetben az üzeneteket a rendszer üresen küldi el. Ez az alapértelmezett beállítás. A MandatoryStartTLS azt jelenti, hogy az SMTP-tranzakciókat titkosítani kell. Az SMTP-tranzakciók megszakadnak, hacsak az SMTP-kiszolgáló nem támogatja a STARTTLS-t. A NoStartTLS azt jelenti, hogy a titkosítás le van tiltva, és az üzeneteket a rendszer törli.
   --skip-verify	false	Ez a beállítás azt szabályozza, hogy egy ügyfél ellenőrzi-e a kiszolgáló tanúsítványláncát és állomásnevét. Ha a --skip-verify igaz, az ügyfél elfogadja a kiszolgáló által bemutatott összes tanúsítványt és a tanúsítványban szereplő bármely gazdagépnevet. Ebben a módban a TLS érzékeny a középső gépi támadásokra, kivéve, ha egyéni ellenőrzést használ. Az alapértelmezett érték hamis. További információ.

Tipp.

Íme néhány tipp az SMTP megfelelő konfigurálásához:

• Ha üzleti e-mail-fiókot használ, például az Office 365-öt, előfordulhat, hogy az SMTP-hitelesítés engedélyezéséhez kapcsolatba kell lépnie a levelezési rendszergazdával (például enable-smtp-auth-for-specific-mailboxes). Ezután létre kell hoznia egy alkalmazásjelszót, és smtp-jelszóbeállításként kell használnia.
• Ha személyes e-mail-fiókot használ, például az Outlookot vagy a Gmailt, létre kell hoznia egy alkalmazásjelszót, és smtp-jelszóbeállításként kell használnia. Vegye figyelembe, hogy a fiókja nem fog működni az e-mail-értesítésekhez, ha többtényezős hitelesítéssel van konfigurálva.
• Javasoljuk, hogy a felügyelt Grafana-munkaterületre való alkalmazás előtt ellenőrizze, hogy az SMTP-konfigurációk a vártnak megfelelően működnek-e. Például használhat egy nyílt forráskód eszközt, például a swaks (Swiss Army Knife for SMTP) segítségével teszt e-mailt küldhet az SMTP-konfigurációk használatával a következő parancs futtatásával egy terminálablakban:

  # fill in all the empty values for the following parameters
  host="" # SMTP host name with port separated by a ":", e.g. smtp.office365.com:587
  user="" # email address, e.g. team1@contoso.com
  password="" # password
  fromAddress="" # source email address (usually the same as user above), e.g. team1@contoso.com
  toAddress="" # destination email address, e.g. team2@contoso.com
  ehlo="" # grafana endpoint, e.g. team1-ftbghja6ekeybng8.wcus.grafana.azure.com
  
  header="Subject:Test"
  body="Testing!"
  
  # test SMTP connection by sending an email
  swaks --auth -tls \
      --server $host \
      --auth-user $user \
      --auth-password $password \
      --from $fromAddress \
      --to $toAddress \
      --ehlo $ehlo \
      --header $header \
      --body $body
  

A Grafana kapcsolattartási pontjainak konfigurálása és teszt e-mail küldése

A Grafana kapcsolattartási pontjainak konfigurálása a Grafana portálon történik:

1. Az Azure Managed Grafana munkaterület áttekintésében válassza ki a végpont URL-címét.

2. Lépjen a Riasztási > kapcsolattartók elemre.

3. Meglévő kapcsolattartó pont frissítéséhez válassza az Új kapcsolattartási pont vagy a Kapcsolattartó szerkesztése lehetőséget .

   

4. Adja hozzá vagy frissítse a Név és a Kapcsolattartó pont típusát.

5. Adjon meg egy cél e-mailt a Címek területen, és válassza a Tesztelés lehetőséget.

6. Válassza a Tesztértesítés küldése lehetőséget, ha az előre megadott tesztüzenettel szeretné elküldeni az értesítést, vagy válassza az Egyéni lehetőséget az üzenet első szerkesztéséhez.

7. Megjelenik egy "Elküldött tesztriasztás" értesítés, ami azt jelenti, hogy az e-mail beállítása sikeresen konfigurálva lett. A teszt e-mail a megadott e-mail-címre lett elküldve. Hibás konfiguráció esetén a rendszer hibaüzenetet jelenít meg.

SMTP-beállítások letiltása

Az SMTP-beállítások letiltásához kövesse az alábbi lépéseket.

Portal

1. Az Azure Portalon lépjen a Konfigurációs > e-mail Gépház elemre, és kapcsolja ki az SMTP-Gépház, hogy a Letiltás megjelenjen.
2. Válassza a Mentés lehetőséget az Azure Managed Grafana-példány érvényesítéséhez és frissítésének megkezdéséhez.

Azure CLI

1. Az SMTP-beállítások letiltásához az Azure Managed Grafana CLI 1.1-s vagy újabb bővítménye szükséges. A bővítmény frissítéséhez futtassa a következőt az extension update --name amg: .

2. Futtassa az az grafana update parancsot egy adott Azure Managed Grafana-példány SMTP-beállításainak konfigurálásához. Cserélje le a helyőrzőket a saját példány adataira.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp disabled
   

   Paraméter	Példa	Leírás
   --resource-group	my-resource-group	Adja meg az Azure Managed Grafana-példány erőforráscsoportjának nevét.
   --name	my-azure-managed-grafana	Adja meg az Azure Managed Grafana-példány nevét.
   --smtp	letiltva	Az SMTP-beállítások letiltásához tiltsa le az entert.

Megjegyzés:

Ha egy felhasználó letiltja az SMTP-beállításokat, a rendszer minden SMTP-hitelesítő adatot eltávolít a háttérrendszerből. Az Azure Managed Grafana nem fogja őrizni az SMTP-hitelesítő adatokat, ha le van tiltva.

Grafana riasztási hibaüzenetek

A Grafana portálon megtalálja a riasztási értesítésekben megjelenő összes Grafana-riasztási > hibaüzenet listáját.

Az alábbiakban néhány gyakori hibaüzenetet talál:

• "A hitelesítés sikertelen: A megadott engedélyezési engedély érvénytelen, lejárt vagy visszavont". Grafana nem tudott csatlakozni az SMTP-kiszolgálóhoz. Ellenőrizze, hogy az Azure Portal SMTP-beállításaiban megadott jelszó helyes-e.
• "Nem sikerült elküldeni a tesztriasztást: az SMTP nincs konfigurálva". Az SMTP le van tiltva. Nyissa meg az Azure Managed Grafana-példányt az Azure Portalon, és engedélyezze az SMTP-beállításokat.

Következő lépések

Ebben az útmutatóban megtanulta, hogyan konfigurálhatja a Grafana SMTP-beállításait. Ha meg szeretné tudni, hogyan hozhat létre jelentéseket, és e-mailben elküldheti őket a címzetteknek, olvassa el az irányítópultok létrehozása című témakört.