Collect NetApp ONTAP SAN logs
This document explains how to ingest NetApp ONTAP SAN logs to Google Security Operations using Bindplane. NetApp ONTAP is a data management software platform for storage systems that provides SAN (Storage Area Network) services including block-level storage using iSCSI, Fibre Channel, and NVMe over Fabrics protocols. ONTAP SAN logs capture events related to LUN operations, initiator group management, port status changes, and storage access activities.
For more information, see Collect NetApp SAN logs.
Before you begin
Make sure you have the following prerequisites:
- A Google SecOps instance.
- A Windows 2016 or later or Linux host with systemd.
- Network connectivity: If running behind a proxy, ensure firewall ports are open per the Bindplane agent requirements.
- Privileged access to the NetApp ONTAP cluster management interface (ONTAP System Manager or CLI).
- ONTAP 9.x or later running on the storage system.
Get Google SecOps ingestion authentication file
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Collection Agent.
- Download the Ingestion Authentication File.
- Save the file securely on the system where Bindplane will be installed.
Get Google SecOps customer ID
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Profile.
- Copy and save the Customer ID from the Organization Details section.
Install the Bindplane agent
Install the Bindplane agent on your Windows or Linux operating system according to the following instructions.
Windows installation
- Open the Command Prompt or PowerShell as an administrator.
Run the following command:
msiexec /i "[https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
Linux installation
- Open a terminal with root or sudo privileges.
Run the following command:
sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
Additional installation resources
For additional installation options, consult this installation guide.
Configure the Bindplane agent to ingest Syslog and send to Google SecOps
Access the configuration file:
- Locate the
config.yamlfile. Typically, it is in the/opt/observiq-otel-collector/directory on Linux or in the installation directory on Windows. - Open the file using a text editor (for example,
nano,vi, or Notepad).
- Locate the
Edit the
config.yamlfile as follows:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/netapp_san: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: NETAPP_SAN raw_log_field: body ingestion_labels: service: pipelines: logs/netapp_san_to_chronicle: receivers: - udplog exporters: - chronicle/netapp_san
- Replace the port and IP address as required in your infrastructure.
- Replace
<CUSTOMER_ID>with the actual customer ID. - Update
/path/to/ingestion-authentication-file.jsonto the path where the authentication file was saved.
Restart the Bindplane agent to apply the changes
To restart the Bindplane agent in Linux, run the following command:
sudo systemctl restart observiq-otel-collectorTo restart the Bindplane agent in Windows, you can either use the Services console or enter the following command:
net stop observiq-otel-collector && net start observiq-otel-collector
Configure syslog forwarding on NetApp ONTAP
Configure syslog using ONTAP CLI
- Connect to the NetApp ONTAP cluster management LIF using SSH.
Enter the following command to view the current event notification destinations:
cluster1::> event notification destination showCreate a syslog notification destination pointing to the Bindplane agent:
cluster1::> event notification destination create -name bindplane-syslog -syslog <BINDPLANE_IP_ADDRESS> -syslog-port 514 -syslog-transport udp-unencrypted- Replace
<BINDPLANE_IP_ADDRESS>with the IP address of the Bindplane agent host.
- Replace
Create an event notification to forward EMS events to the syslog destination:
cluster1::> event notification create -filter-name default-trap-events -destinations bindplane-syslog(Optional) Create a custom filter to include all events:
cluster1::> event filter create -filter-name all-events cluster1::> event filter rule add -filter-name all-events -type include -message-name * -severity <=NOTICE cluster1::> event notification create -filter-name all-events -destinations bindplane-syslogVerify the configuration:
cluster1::> event notification destination show cluster1::> event notification show
Configure syslog using ONTAP System Manager
- Sign in to ONTAP System Manager.
- Go to Events & Jobs > Events > EMS Event Notifications.
- Click Add to create a notification destination.
- Provide the following configuration details:
- Name: Enter
bindplane-syslog. - Type: Select Syslog.
- Syslog Server: Enter the IP address of the Bindplane agent host.
- Port: Enter
514. - Transport Protocol: Select UDP.
- Name: Enter
- Click Save.
- Create an event notification rule and associate it with the
bindplane-syslogdestination. - Select the event filter (for example,
default-trap-eventsor a custom filter). - Click Save.
For more information, see NetApp ONTAP EMS configuration documentation.
UDM mapping table
| Log Field | UDM Mapping | Logic |
|---|---|---|
desc |
metadata.description |
Directly mapped |
datetime |
metadata.event_timestamp |
Parsed as MMM d HH:mm:ss |
ip |
principal.ip |
Merged |
port |
principal.port |
Directly mapped |
userid |
principal.user.userid |
Directly mapped |
sr |
security_result |
Merged |
| N/A | metadata.event_type |
Constant: STATUS_UPDATE |
| N/A | metadata.product_name |
Constant: Storage Area Network |
| N/A | metadata.vendor_name |
Constant: NetApp |
Need more help? Get answers from Community members and Google SecOps professionals.