Alarms & Audit-Trail tutorial (Tutorial) teaches how to configure alarm conditions, notifications, and audit trail for compliance. Learn to create alarm groups, define triggers, and set up logging for FDA 21 CFR Part 11 compliance. What You'll Learnyou to:
- Create alarm groups and items
- Configure alarm conditions
- Set up notifications
- Enable audit trail for FDA 21 CFR Part 11 compliance
Prerequisites:
- Add Tags to UNS (Tutorial) - uses TankFarm tags
In this page:
Table of Contents maxLevel 2 minLevel 2 indent 10px exclude Steps style none
What You'll Learn
- Create alarm groups and items
- Configure alarm conditions
- Set up notifications
- Enable audit trail
Step 1:
CreateConfigure Alarm Groups
- Navigate to Alarms → Groups
- Add Verify pre-defined groups exist:
Group | AckRequired |
---|
Critical Alarms:
- Name:
Critical
- Priority: 1
- Acknowledgment: Required
- Sound: Critical.wav
- Color: Red
Warnings:
- Name:
Warnings
- Priority: 3
- Acknowledgment: Optional
- Color: Yellow
LogEvents | Priority | ||
---|---|---|---|
Critical | True | True | High |
Warning | False | True | Medium |
AuditTrail | False | True | Hidden |
Modify Critical group:
- Open the ComboBox Sound field
- Select Exclamation
- Press Enter
Step 2: Create
Step 2: DefineAlarm Items
- Go to Alarms → Items
- Create Add high temperature alarm:
High Temperature:
- Name:
Tank1_HighTemp
- Group:
Critical
- Tag:
Tank1_Temperature
- Condition: Greater than
- Limit: 85
- Message: "Tank 1 temperature exceeds limit"
- Deadband: 2
Low Level:
- Name:
Tank1_LowLevel
- Group:
Warnings
- Tag:
Tank1_Level
- Condition: Less than
- Limit: 10
- Message: "Tank 1 level low"
Step 3: Configure Deviation Alarms
For rate-of-change monitoring:
- Name:
Pressure_Deviation
- Type: Deviation
- Tag:
Line_Pressure
- Setpoint Tag:
Pressure_Setpoint
- Deviation: ±10
- Time: 60 seconds
Step 4: Set Up Email Notifications
- Navigate to Alarms → Groups
- Select group → Email settings:
- SMTP Server:
mail.company.com
- Port: 587
- From:
scada@company.com
- To:
operators@company.com
- Subject: "Critical Alarm: {AlarmName}"
- SMTP Server:
Property | Value |
---|---|
TagName | Tag.TankFarm/Tank1/Temp |
Condition | HiHi |
Limit | 85 |
Group | Critical |
Message | Tank 1 Critical Temperature: {Tag.TankFarm/Tank1/Temp}°C |
Priority | 100 |
- Add low level alarm:
Property | Value |
---|---|
TagName | Tag.ankFarm/Tank1/Level |
Condition | Lo |
Limit | 20 |
Group | Warning |
Message | Tank 1 Low Level Warning |
Priority | 50 |
Step 3: Configure Alarm Areas
- Navigate to Alarms → Areas
- Create hierarchy:
- Plant
- Production
- Tank1
- Tank2
- Utilities
- Production
- Assign alarms to areas:
- Return to Alarms → Items
- Set Area =
Plant.Production.Tank1
for both alarms
Step 4: Enable
Step 5: ConfigureAudit Trail
- Go to Alarms → Global Settings
- In Audit Trail section:
- Check Enable Audit Trail
- Enable
- options:
- User Logon/Logoff
- Tag Changes
- Alarm Acknowledgments: Yes
- Configuration Changes: Yes
- Set storage:
- Database: SQL Server
- Table: AuditTrail
- Retention: 365 days
Step 6: Create Alarm Areas
For plant organization:
- Alarms → Areas
- Create hierarchy:
Plant/
??? Production/
? ??? Line1/
? ??? Line2/
??? Utilities/
??? Boilers/
??? Compressors/
- Assign alarms to areas
Step 7: Test Alarms
- Start Runtime
- Open Alarms → Online
- Force tag values to trigger alarms
- Verify:
- Alarm appears in list
- Color coding correct
- Sound plays
- Email sent
Step 8: Alarm Summary Display
Create operator display:
- Displays → New
- Add AlarmViewer control
- Configure:
- Show: Active alarms
- Columns: Time, Area, Message, Value
- Filter: By area or priority
- Allow: Acknowledge, silence
FDA 21 CFR Part 11 Setup
For compliance:
- Electronic signatures on acknowledgments
- Audit trail cannot be disabled
- User authentication required
- Time synchronization enabled
- Data integrity checksums
Best Practices
- Use consistent naming conventions
- Set appropriate priorities (1-5)
- Include clear messages
- Test all alarm conditions
- Document alarm philosophy
- Regular alarm rationalization
Next Steps
- Operator Actions
- Custom Messages
- Configure database retention:
- Life Time: 2555 days (7 years for FDA compliance)
Step 5: Create Alarm Display
- Navigate to Displays → New
- Name:
AlarmMonitor
- Add AlarmViewer control from toolbox
- Configure properties:
- List: OnlineAlarms
- ShowAcknowledged: False
- Columns: Time, TagName, Message, Value, Group
- Add AlarmArea control for navigation
- Save display
Step 6: Test Alarms
- Start Runtime (Runtime → Startup)
- Open Runtime → Online Alarms
- Simulate alarm conditions:
csharp
// In Script Task or Watch Window
@Tag.Tank1_Temp = 90; // Triggers high temp
@Tag.Tank1_Level = 15; // Triggers low level
- Verify in AlarmViewer:
- Critical alarm shows red
- Warning shows yellow
- Sound plays for Critical
- Acknowledge required for Critical
- Test acknowledgment:
- Right-click Critical alarm
- Select Acknowledge
- Verify state change
Step 7: Verify Audit Trail
- Change AlarmViewer List to
AuditTrail
- Verify logged events:
- User login
- Alarm triggers
- Acknowledgments
- Tag changes
- Add custom message via script:
csharp
@Alarm.GlobalSettings.AuditTrail.AddCustomMessage(
"Tutorial test completed by " + @Client.UserName
);
Next Steps
- [Configure Email Notifications] - Set up SMTP
- [Create Alarm Reports] - Historical analysis
- [FDA Compliance Setup] - Full 21 CFR Part 11
Step-by-step guide to configure alarm groups, conditions, notifications, and audit trail for operational monitoring and FDA compliance.
In this section...
Page Tree | ||||
---|---|---|---|---|
|