Check an endpoint's status

For connections using VPN or port integrations, you can check the status of an endpoint in the Redox dashboard. You may want to do this if you see one or more failed requests to a VPN or port endpoint on either side of the integration.

If you don't see an endpoint status, it means that the integration doesn't use VPN to exchange data.

VPN tests

A status check can include one or both of these types of tests, depending on whether you send or receive data:

  1. Security association: Tests that both servers have the necessary information to exchange data securely. This tells you whether the VPN tunnel is active (green or red status).
  2. TCP heartbeat or ping: Tests whether the endpoint is actually receiving data. If you own the endpoint (i.e., you're receiving the data), the status can be either green or gray. If your connection owns the endpoint (i.e., you're sending the data), the status can be green, yellow, or gray status.

If you're sending data, a status check includes both #1 and #2.

If you're receiving data, a status check only includes #2.

TCP heartbeat verses ping

But first, there are different tests to check a VPN or port integration, depending on whether you're sending or receiving data. These tests can be done with a TCP heartbeat or a ping. We recommend using a TCP heartbeat since it's more reliable, but not all interface setups support TCP heartbeat. Read more about each of these methods:

If you see a ping but know that you can support TCP heartbeat, submit a ticket via our Help Desk so that we can update your configuration.

Check an endpoint status on VPN networks

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Connections page.
  3. All of your connections display on the page. Select the connection that you want to check.
    Select a connection
    Select a connection
  4. The Data Flow tab opens with more detailed information:
    1. Data flow: The directionality of the information. Read more about data flows.
    2. Endpoint status:
      1. Red: VPN tunnel isn't active.
      2. Yellow: This has an ECONNREFUSED status and means that the test went through but the endpoint hasn't acknowledged it. This could be because:
        1. The endpoint was tied up with another data exchange;
        2. The organization that owns the endpoint ignored the test; or
        3. The sender may have the wrong port settings for the endpoint. Contact your connection to confirm the settings.

          Yellow may not mean failure

          One important thing to note about an ECONNREFUSED status is that it could just be a temporary state. It doesn't indicate a failed VPN connection for certain.

          If you do see a yellow status, don't worry about reaching out to Redox just yet. We recommend monitoring your traffic to see if any messages go through at all or whether the status corrects itself over time in the dashboard.

      3. Green: VPN tunnel is active or the endpoint test was successful and acknowledged.
      4. Gray: This may happen for legacy connections, and it means there's not sufficient information to test. Submit a ticket via our Help Desk so that we can update your VPN metadata to enable testing.
  5. Locate the data flow that you want to check and hover over the status icon. The Network Status List modal appears with the details for the given data flow, along with the IP and port values.
    Check the status of a VPN connection
    Check the status of a VPN connection
  6. Alternatively, you can click the endpoint name. The endpoint page opens with more details:
    1. Base info: Describes the endpoint.
    2. Status info: Displays the results from the VPN tests.
    3. VPN data: Shows the IP and port values for both sides of the integration.
      Check the endpoint details
      Check the endpoint details