Amazon Web Services: Camera Ingestion and Storage

This section describes the Amazon Web Services storage path documented for SiteTrax.io camera ingestion. Confirm the bucket, access method, retention and notification configuration for your deployment with SiteTrax.io before setup. Customer-owned storage does not imply that the entire SiteTrax.io application runs in the customer’s cloud account.

Amazon S3 storage ownership and retention

• Many third-party cameras support Amazon S3 as an upload destination.
• Decide whether you already have S3 buckets you prefer to use, or would rather use SiteTrax.io-managed storage.
• Align early on ownership, access, retention, and cost assumptions.

A note on data retention: When you use your own S3 buckets, you own the storage and therefore define your own data retention policy for raw video and interpreted images — keeping it as long or as short as your business and compliance needs require. You can manage this with S3 lifecycle rules; see Amazon's Managing the lifecycle of objects documentation. If you instead use SiteTrax.io-managed storage and need to keep raw video and interpreted images for longer than 90 days, SiteTrax.io recommends working with the team to store the data on a customer-provided solution such as Amazon AWS S3 — which is why customers who need longer retention typically bring their own S3 buckets.

For how video is ingested from S3, see SiteTrax.io API — Input (Video).

S3 Upload and Integration Requirements

For your BYOC deployment to work with SiteTrax.io Gate, your camera must deliver video into the SiteTrax.io processing pipeline through Amazon S3. SiteTrax.io analyzes the video stored in the S3 bucket, creates structured asset observations, and pushes the results to your REST API server and the SiteTrax.io Intelligence.

Setting Up the S3 Bucket and Upload Folder

Based on the documented ingestion flow, configure your storage as follows:

• Use a dedicated S3 bucket. You may use your own bucket or one provided by SiteTrax.io. For creating and configuring a bucket, see Amazon's Creating a bucket documentation.
• Upload videos to the notprocessed folder. Files should be uploaded to {bucket_name}/notprocessed. SiteTrax.io watches this folder and begins processing once an upload completes.
• Upload using the presigned URL. Your SiteTrax.io representative will give you a project-specific URL. A POST request (with the video file name and "method": "put_object") returns a presigned URL that is active for 300 seconds; upload the video to that URL. See Amazon's Using presigned URLs documentation for the upload mechanics.
• Meet the video specifications. Keep each clip to about one minute, use 1920x1080 at 30 fps, a 6 mm or longer lens, and embed GPS in the subtitle stream (this can be fixed for static cameras). Full details are in SiteTrax.io API — Input (Video).
• Grant SiteTrax.io access. If you bring your own bucket, agree the required access method and permissions with SiteTrax.io. Request the deployment-specific setup procedure from your SiteTrax.io representative; do not paste access keys into assistant conversations.

Optional: Event Notifications

If your deployment uses event-driven notifications (for example, an Amazon SNS topic) to signal that a new object has been written to the bucket, the topic and its configuration values must be provided and confirmed by SiteTrax.io so they target the correct SiteTrax.io endpoint. For background on creating a topic, see Amazon's Creating an Amazon SNS topic documentation, then coordinate the specifics with SiteTrax.io as described below.

Obtaining the Bucket, Access, and Notification Details

To keep this infrastructure secure, the specific backend configuration values — including any notification topic details and the S3 access setup — are not published on this page. To obtain them and complete your configuration:

• Submit a support ticket via the SiteTrax.io support page, or contact your SiteTrax.io account representative, to request the S3 bucket, access keys, and any notification configuration for your deployment.
• The team will provide the project-specific upload URL and step-by-step setup instructions directly to you.
• Have your deployment information ready (site, intended S3 bucket, and camera details) so the team can scope the configuration to your environment.

If processed records do not appear after upload, check the SiteTrax.io status page; if all services are operational, submit a support ticket.