Manual Chapter : How can I get set up BIG-IQ to alert me when certain events happen on my managed devices

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.1.0
Manual Chapter

You can easily integrate BIG-IQ® to work with SNMP and/or SMTP. After you set up SNMP and/or SMTP on BIG-IQ, you can choose alerts that prompt a message to be sent when the event or a threshold is met on a managed BIG-IP device.

How do I set up BIG-IQ to work with SNMP?

Simple Network Management Protocol (SNMP) is an Internet-standard protocol for collecting and organizing information about managed devices on IP networks. You can set up BIG-IQ® to work with SNMP so you can receive alerts when certain things happen on a managed device.

To set up BIG-IQ to work with SNMP, you must:
  1. Set up the SNMP Agent
  2. Configure SNMP Access
  3. Specify settings for the SNMP Trap

Before you configure SNMP

Gather the following information before you start your SNMP configuration.

CONFIGURATION COMPONENT CONSIDERATIONS
SNMP administrator contact information Find out or decide who is responsible for SNMP administration. The contact information is a MIB-II simple string variable.
Machine location Find out the location of the BIG-IQ system. The location is a MIB-II simple string variable.
BIG-IQ client allow list Gather the IP or network addresses (with netmasks) of the SNMP managers from which the SNMP agent will accept requests.
Access Find the OID for the top-most node of the SNMP tree to provide access to.
Community Get the v1 and v2c communities and the IP addresses of the SNMP managers you want to grant access to.
Users Get the v3 users you want to grant access to SNMP data, along with the privacy protocols and passwords, Community, Destination, and Port.

Configuring SNMP agent for sending alerts

You configure the SNMP on BIG-IQ® so the SNMP manager can collect data for receiving alerts when certain things happen on your managed devices.

  1. Log in to F5® BIG-IQ® Centralized Management with your user name and password.
  2. At the top left of the screen, select System Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. On the left, click LOCAL HOST SETTINGS > SNMP Configuration > SNMP Agent .
    The screen displays the SNMP settings.
  5. At the top of the screen, click the Download MIB button to download the F5-required MIBs.
  6. At the top of the screen, click Edit.
  7. Edit the Contact Information and Machine Location fields to reflect your SNMP agent settings and click the Save button at the bottom of the screen.
  8. For the SNMP Access - Client Allowed List setting, click the Add button.
  9. In the Addresses/Networks and Mask fields, type the IP address and networks and the netmask (if applicable) that the SNMP manager is allowed to access.
  10. To add another address, click the plus ( + ) sign.
  11. Click the Save button when you are finished.
You can now configure SNMP access and SNMP traps.

Configuring Access and Traps for SNMP version 1 and 2C to send alerts

You configure SNMP access to allow the SNMP agent to accept requests from specific SNMP managers.

  1. Log in to F5® BIG-IQ® Centralized Management with your user name and password.
  2. At the top left of the screen, select System Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. On the left, click LOCAL HOST SETTINGS > SNMP Configuration > SNMP Access (v1, v2C)
  5. Click the Add button.
  6. In the Name field, type the SNMP manager's user name.
  7. From the Type list, select the format for the IP address.
  8. In the Community field, type the community string (password) for access to the MIB.
  9. From the Source list, select a source or select Specify and type the source address for access to the MIB.
  10. In the OID field, type the object identifier (OID) you want to associate with this user.
  11. From the Access list, select an option:
    • Read Only - This user can only view the MIB.
    • Read/Write - This user can view and modify the MIB.
    The most secure access level or type takes precedence when there is a conflict. When you set the access level to read/write, and an individual data object has a read-only access type, access to the object remains read-only.
  12. Click the Save button at the bottom of the screen to save your changes.
  13. On the left, click SNMP Traps.
  14. In the Name field, type a name for this SNMP trap.
  15. From the Version list, select v2 or 2C.
  16. In the Community, Destination, and Port fields, type, respectively, the community name, IP address, and port for the trap destination.
  17. Click the Save button at the bottom of the screen to save your changes.
You can now specify alert conditions, by clicking ALERTS on the left.

Configuring Access and Traps for SNMP version 3 to send alerts

You configure SNMP access to allow the SNMP agent to accept requests from specific SNMP managers.
  1. Log in to F5® BIG-IQ® Centralized Management with your user name and password.
  2. At the top left of the screen, select System Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. On the left, click On the left, click LOCAL HOST SETTINGS > SNMP Configuration > SNMP Access (v3) .
  5. Click the Add button.
  6. In the Name and User Name fields, type a name for this SNMP access and the user name.
  7. If you want to specify the authentication protocol for SNMP traps, from the Type list, select an option.
    • MD5 specifies digest algorithm.
    • SHA specifies secure hash algorithm.
  8. If you selected an authentication protocol, in the Password and Confirm Password fields, type and confirm the password for access.
  9. If you want to encrypt the SNMP traps, from the Protocol list, select an option.
    • AES specifies Advanced Encryption Standard
    • DES specifies Data Encryption Standard
  10. In the Password and Confirm Passwordfields, type and confirm the password for access.
    The password must be between 8 and 32 characters, include alphabetic, numeric, and special characters, but no control characters.
  11. In the OID field, type the object identifier (OID) you want to associate with this user.
  12. In the Destination, and Port fields, type the IP address and the port for the trap destination.
  13. From the Security Level list, select the level of security at which you want SNMP messages processed.
    • Auth, No Privacy process messages without encryption.
    • Auth & Privacy process messages using authentication and encryption.
  14. In the Security Name field, type the user name the system uses to handle SNMP v3 traps.
  15. In the Engine ID field, type an administratively unique identifier for an SNMP engine.
    This setting is optional. You can find the engine ID in the /config/net-snmp/snmpd.conf file as the value of the oldEngineID token.
  16. From the Authentication Protocol list, select the type of authentication to use to authentication SNMP v3 traps.
  17. In the Password and Confirm Password fields, type and confirm a password for this SNMP trap.
  18. On the left, click SNMP Traps.
  19. In the Name field, type a name for this SNMP trap.
  20. From the Version list, select V3.
  21. In the Community, Destination, and Port fields, type, respectively, the community name, IP address, and port for the trap destination.
  22. Click the Save button at the bottom of the screen to save your changes.
You can now specify alert conditions, by clicking ALERTS on the left.

How do I set up BIG-IQ to work with SMTP?

To have a specific recipient receive an email message when an alert is triggered by a system event, configure BIG-IQ® to deliver locally-generated email messages using the internet-standard for electronic mail transmission, Simple Mail Transfer Protocol (SMTP). Sending an email alert ensures that administrators are immediately notified when a specific system event occurs so they can quickly troubleshoot potential issues.

To set up BIG-IQ to work with SMTP, you must:

  1. Set up an SMTP Server
  2. Add SMTP Email Recipients

Configuring SMTP for sending alerts

You must configure a DNS server before you can specify an SMTP server.

You set up an SMTP server to send email to alert certain people when a specific condition happens, such as when an SSL certificate is about to expire.
  1. Log in to F5® BIG-IQ® Centralized Management with your user name and password.
  2. At the top left of the screen, select System Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. On the left, click LOCAL HOST SETTINGS > SMTP Configuration .
  5. Click the Add button at the upper right of the screen.
  6. In the Name field, type a name for this SMTP configuration.
  7. In the SMTP Server Host and SMTP Server Port fields, type the SMTP server and TCP port.
    By default, SMTP uses TCP 25.
  8. In the From Email Address field, type the email address from which to send the alert email.
  9. From the Encryption list, select the type of encryption to use for the email.
  10. To require a user name and password, from the Use Auth list, select Yes, and type the required user name and password.
  11. Click the Save button at the bottom of the screen.
  12. For the SMTP Email Recipients setting, click the Add button.
  13. In the Name and Email Address fields, type the name and the email address for the person you want to receive an email when a specified alert condition is met.
  14. To add more recipients, click +.
  15. When you're done adding email recipients for alerts, click the Save button at the bottom of the screen.
  16. To verify that you can reach the server you configured, click the Edit button at the upper right of the screen, and click the Test Connection button.
    You must specify at least one email recipient to test the connection.
You can now set up the alert conditions that prompt the BIG-IQ® system to send an email when a certain event happens on a managed device.

Setting up alert conditions

After you set up the SNMP and/or SMTP on BIG-IQ®, you can select the alerts that prompt BIG-IQ to send an email to the people you specified.
  1. Log in to F5® BIG-IQ® Centralized Management with your user name and password.
  2. At the top left of the screen, select System Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. On the left, click ALERTS.
  5. Click the Edit button at the top of the list.
  6. Select the Enabled check box next to alert conditions you want to enable, and (where applicable) in the Threshold field, type the maximum point the condition should reach before BIG-IQ notifies you.
  7. Click the Save button at the bottom of the screen.