Edge Delta on Windows

Installing the Edge Delta Fleet on Windows.

  4 minute read  

Edge Delta uses 64-bit or 32-bit MSI installation process.

Note: not all version 3 features are available on a Windows installation. You can install v2 agents.

Install a Fleet

Select the Windows template option in the following steps:

  1. Click Pipelines.
  2. Click New Fleet.
  3. Select Edge Fleet and click Continue.
  4. Select the appropriate template and click Continue.
  5. Specify a name to identify the Fleet.
  6. Click Generate Config.
  7. Execute the installation commands, they include the unique ID for the Fleet.
  8. Expand the namespaces and select the input sources you want to monitor.
  9. Select the Destination Outputs you want to send processed data to, such as the Edge Delta Observability Platform.
  10. Click Continue.
  11. Click View Dashboard.

Permissions

Note you may need to use elevated permissions:

  1. Right click the Windows button
  2. Select Windows PowerShell (Admin). Alternatively:
  3. Click the Windows button and search for PowerShell
  4. Right-click on PowerShell.
  5. Select Run as administrator.

The windows installation command for the Edge Delta Fleet performs the following functions:

  • Uninstalls any existing Edge Delta products.
  • Downloads the latest Edge Delta Fleet MSI installer.
  • Installs the Fleet using the provided Pipeline ID with no user interaction.

Upgrade the Fleet

To upgrade the Fleet, you run the installation steps again.

Uninstall

You can uninstall the Fleet using PowerShell:

(Get-WmiObject -Query "SELECT * FROM Win32_Product WHERE Name like 'Edge Delta%'").uninstall()

Troubleshoot Windows Installations

Check for Elevated Permissions

You require elevated permissions to install the Edge Delta Fleet. Verify Administrator Rights:

  1. Right-click on PowerShell.
  2. Select Run as administrator.
  3. Confirm elevated permissions:
[bool]([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

The command should return True if you have elevated permissions.

Ensure the Edge Delta Fleet is Running

Using tasklist: Run the following command in PowerShell to check if the Edge Delta Fleet process is running:

tasklist | findstr /i "edgedelta"

Look for the edgedelta process in the output.

Using Task Manager:

  1. Open Task Manager (Ctrl + Shift + Esc).
  2. Go to the Processes tab.
  3. Look for the Edge Delta Fleet process.

Check for Windows Event Logs

When setting up observability for a Windows system, the Fleet collects and sends Windows Event Logs to the observability platform. However, if the host system isn’t generating new events, the Fleet will have no data to collect.

  1. Press Win + R to open the Run dialog and enter
eventvwr
  1. Navigate to different event log categories such as Windows Logs - Application, Security, System, etc. Ensure that new events are being recorded. Look for recent entries with timestamps indicating ongoing activity.
  2. Generating Test Events if the logs seem inactive:
  • System Log: Disable and re-enable a network adapter. This should generate system events.
  • Application Log: Open and close various applications, which should generate application-specific events.
  • Security Log: Login and logout, or run the command gpupdate in Command Prompt to generate security-related events.
  1. Recheck the Event Viewer to confirm that new events are created.

View Fleet Logs

Log File Path:

  1. Identify the log file path for the Edge Delta Fleet. The default should be
C:\Program Files\EdgeDelta\edgedelta.log
  1. Open the log file using a text editor like Notepad:
notepad "C:\Program Files\EdgeDelta\edgedelta.log"

Review the log for any errors or warnings.

Verify the Fleet Health in the Edge Delta UI

  1. Login to Edge Delta
  2. Click Pipelines - Dashboard
  3. Select the pipeline and click Agents
  4. Check that there is a Processing agent, a compactor, and at least one Rollup Agent.
  5. Check that each agent has a healthy flag.

Validate Pipeline ID Configuration

Check Registry Settings:

  1. Open Registry Editor.
regedit
  1. Navigate to the location where Edge Delta stores its configurations: HKEY_LOCAL_MACHINE\SOFTWARE\Edge Delta.
  2. Verify the Pipeline ID is correctly configured:
HKEY_LOCAL_MACHINE\SOFTWARE\Edge Delta\APIKEY

The value should match the Pipeline ID provided during installation.

Check Network Connectivity

Verify Internet Connectivity:

  1. Open PowerShell and try pinging a reliable server:
ping www.google.com

Ensure you receive replies indicating active internet connectivity. 2. Check the connection to Edge Delta:

ping release.edgedelta.com

Ensure you receive responses.

Update or Reinstall the Fleet

  1. Open PowerShell with elevated permissions.
  2. Uninstall the old Fleet:
Get-WmiObject -Query "SELECT * FROM Win32_Product WHERE Name like 'Edge Delta%'" | ForEach-Object { $_.Uninstall() }
  1. Follow the installation steps to download and install the latest Edge Delta Fleet MSI package.

Contact Support

If these steps do not resolve the issue, gather the necessary logs and details about the system’s configuration and contact support for further assistance.