Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added new way of configuration. #1560

Open
wants to merge 2 commits into
base: suse-observability
Choose a base branch
from
Open

Added new way of configuration. #1560

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a4a16c9
Added new way of configuration.
amolkharche13 Dec 17, 2024
41b406d
## Troubleshooting, changed numbering
amolkharche13 Dec 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 51 additions & 1 deletion setup/configure-stackstate/email-notifications.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,5 +41,55 @@ stackstate:
```

### Using an external secret
          When the username and password cannot be provided in the values but should come from an external secret, follow [these steps](/setup/security/external-secrets.md#getting-username-and-password-for-email-sending-from-an-external-secret)

When the username and password cannot be provided in the values but should come from an external secret, follow [these steps](/setup/security/external-secrets.md#getting-username-and-password-for-email-sending-from-an-external-secret)


To apply the changes, use the command: helm upgrade by passing --values values.yaml,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You now put this text into the ### Using an external secret section (probably happened with the conflict resolution). You probably want to have this right above that header.


This will use port `587` on the SMTP server and uses the `STARTTLS` command to establish a secure connection.


Once the changes are applied, navigate to the SUSE Observability URL, then go to **Notifications** → **Add New Notification**.
Fill in the required details, select **Email** as the channel, and click **Add Channels** when you're done.
Finally, click the ▶️ TEST button to verify if your configuration is correct.

![image](https://github.com/user-attachments/assets/7affa8c3-596c-477d-9591-6140fee1c431)
![image](https://github.com/user-attachments/assets/6827310e-f991-4ade-9f24-78c1f5dac282)
![image](https://github.com/user-attachments/assets/0b5c730f-51bf-403f-926c-a5d1ebe283bd)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please include the images as files in the git repository as part of this PR.

We store images in the .gitbook/assets directory, so that they are versioned and accessible for Gitbook to use. I doubt it will work with images stored simply as user-attachments on github and we don't want to risk Github cleaning them up after a while.

Copy link
Contributor Author

@amolkharche13 amolkharche13 Dec 17, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems I don't have access to push. Attaching zip files contain 6 images.
remote: Permission to StackVista/stackstate-docs.git denied to amolkharche13.

email_notifications.zip


If your configuration is correct, you will receive a test email.

![image](https://github.com/user-attachments/assets/6034f6b4-9254-4005-844f-f6fe2c52436e)
![image](https://github.com/user-attachments/assets/bfef3caf-19c2-47eb-bad9-38913afeb984)


### Troubleshooting
1. If you encounter an error message when clicking the ▶️ TEST button, check the logs on your SMTP server, typically located under `/var/log/mail.log`. You should find some clues to help resolve the issue.

![image](https://github.com/user-attachments/assets/85af37e9-86ec-4668-9cbf-d8430d07071c)

2. If you encounter the _disconnect from unknown_ error message in the SMTP server logs, you will need to add the cluster node IP to the `main.cf` configuration file.

```
postfix/smtpd[7635]: disconnect from unknown[165.232.178.159] ehlo=2 starttls=1 mail=1 rcpt=0/1 rset=1 quit=1 commands=6/7
postfix/smtpd[7635]: connect from unknown[165.232.178.159]
```
```
cat /etc/postfix/main.cf|grep -i mynetworks
mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128 165.232.178.159/32 165.232.190.163/32
```
3. If you encounter the _Relay access denied_ error message in the SMTP server logs, The error message Relay access denied typically occurs when your Postfix SMTP server rejects an email due to misconfigured relay settings.
```
postfix/smtpd[6310]: NOQUEUE: reject: RCPT from unknown[165.232.178.159]: 454 4.7.1 Relay access denied; from=<example.com> to=<user1> proto=ESMTP helo=<suse-observability-server-8f6866c5d-46bth>
```
Try adding the domain to relay_domains in the `main.cf`:
```
relay_domains = example.com
```
4. If you encounter the error below, it indicates a connection issue between the client (or sender) and the SMTP server. To troubleshoot, test the connection between the servers by running the following command: `telnet smtp.example.com 25`.
```
"message": "Operation timeout error.",
"errorCode": 408,
"_type": "ServerTimeoutError"
```