Networking

Core Data Flows

Description	Flow	Protocol	Ports / URLs	Notes
Video Feeds	Cameras / VMS → Edge Clusters	RTSP(S), MJPEG, HLS	554 for RTSP, 80 or 443 for HLS/MJPEG	To ingest live video feeds
Edge Communication	Edge Cluster → Control Plane	HTTPS	443. Websockets	Heartbeat. High frequency, low volume per request. Scales with number of cameras
Licensing *	Control Plane / Edge Cluster → VisualCortex Cloud	HTTPS	443. https://manage.visualcortex.com	License check and aggregate metrics. Low frequency
Container Image Downloads ✝	Edge Cluster / Control Plane → VisualCortex Container Registry	HTTPS	443. australia-southeast1-docker.pkg.dev	Low frequency, large volume. Used only when deploying/updating
Cloud Alerts *	Control Plane / Edge Cluster → VisualCortex Cloud	HTTPS	443. https://manage.visualcortex.com	Used for SMS, Email alerting

* = This is disabled in air-gapped deployments

✝ = Disabled in air-gapped deployments. You can also mirror VisualCortex images into your own compatible OCI Image registry

External Event Integrations

From Control Plane or Edge cluster to external event integrations.

VisualCortex can optionally send real time event information to other sources if required. Typical uses for this include ingesting data into a customer’s data warehouse, invoking a webhook in real time when an event happens or pushing data onto an event queue.

Type of data: Machine Learning Aggregated Event Data (See below), Information about internal VisualCortex cameras / virtual cameras.

Interface Protocol: Depends on the integration type. Typically HTTPS.

Frequency: Up to once every second. Payload is usually under 200kb but greatly depends on the number of cameras, models being run, and detected events.

Typical ports:

Integration Type	Protocol	Port / Host
BigQuery	HTTPS	443. Host Information
Pub/Sub	HTTPS	443. Typically pubsub.googleapis.com or {region}-pubsub.googleapis.com (e.g., us-central1-pubsub.googleapis.com)
Webhook / Edge Webhook	HTTP/HTTPS	Typically 80 or 443. Up to the user
Kafka	Kafka protocol	Typically 9092, 9093
Postgres	Postgres Wire protocol	Typically 5432

Sample Data

Directional Count

[
  {
    "type": "event",
    "payload": {
      "entity_id": "48f73949-01be-44c5-b4f7-ae2c1ad202b9",
      "entity_type_cd": "camera",
      "transformation_name": "vc_line_cross",
      "transformation_version": "1.0.0",
      "processing_entity_id": "a58f9979-78ff-4ffd-9923-74e17abb057f",
      "processing_entity_type_cd": "edge_box",
      "event_dttm": "2023-10-19T02:45:43.127Z",
      "data_json": {
        "event_definition_uuid": "65b8a0cb-6c5d-4937-bd0d-e9f26933a1ca",
        "object_uuid": "b9238484-03b6-4f20-ab56-af915f26e99e",
        "direction": "exit",
        "label": "person"
      },
      "created_at": "2023-10-19T02:45:43.182Z"
    }
  }
]

Dwell

[
  {
    "type": "event",
    "payload": {
      "entity_id": "48f73949-01be-44c5-b4f7-ae2c1ad202b9",
      "entity_type_cd": "camera",
      "transformation_name": "vc_dwell",
      "transformation_version": "1.0.0",
      "processing_entity_id": "a58f9979-78ff-4ffd-9923-74e17abb057f",
      "processing_entity_type_cd": "edge_box",
      "event_dttm": "2023-10-19T02:45:43.132Z",
      "data_json": {
        "event_definition_uuid": "d22a8428-191a-4ab3-b9ee-4b794f114f0f",
        "object_uuid": "203fab94-60c8-465f-b784-ba90654e9afd",
        "dwelltime_seconds": 2.1,
        "label": "person"
      },
      "created_at": "2023-10-19T02:45:43.180Z"
    }
  }
]

Video Management System Integrations

For VisualCortex Video Management Systems, the below table lists typical ports needed.

Integration Type	Protocols	Port
Milestone	HTTPS, ImageServer	443 to the Management Server, 7563 to the appropriate ImageServer servers (Typically Recording Servers)
Milestone AI Bridge	GraphQL, SOAP, RTSP, HTTP(S). See here for more details	Typically 4001 for GraphQL, 8554 for RTSP
Genetec	RTSP, REST/HTTP(S). See here for more details	Typically 443 for REST, 554/654 for RTSP
NX Witness Cloud	HTTPS	443. Uses https://nxvms.com, https://XXXXX.relay.vmsproxy.com where XXXXX is your system ID
Digifort	HTTP(S), RTSP	RTSP typically 554. Default HTTP API is on 8601