Diagnosing Usage Log Server Behaviors
Learn how to diagnose connectivity-related behavior with the Usage Log Server.
To learn more about Usage Logs, see the Usage Logs Guide.
For guidance on Configuring Persistent Storage for the Usage Log Server, see the Usage Log Server - Storage Directory Configuration.
New Integrations
If you are integrating the FaceTec Server for the first time, please see the FaceTec Server Integration Guides.
From configurations on local machines to Cloud Hosting Services, these guides have comprehensive step-by-step procedures and videos to assist users in running the FaceTec Server.
Port Configurations for the FaceTec Server
The below table shows the inbound and outbound ports that must be properly configured for the FaceTec Server to function.
| Port Number | Port Type | Description |
|---|---|---|
| 22 | Outbound | SFTP Outbound Port for sending data to logs.facetec.com (54.70.182.147 - Static IP Address). |
| 443 | Outbound | HTTPS Outbound Port for sending data to usage-logs.facetec.com. |
| 3000 | Inbound | Inbound Port for receiving data from Your Team's Usage Log Server. |
| 8080 | Inbound | Inbound Port for receiving API Requests. |
Usage Log Server Network
If you are encountering a Usage Log Server status, this may be related to Your Network Configuration. To resolve it, you must ensure that your Server is able to make outbound network requests to FaceTec in order to send HTTPS or SFTP usage logs (please see the table above for network connection information that MUST be allowed).
Disclaimer: Making changes to your Network Configuration has the potential to introduce security vulnerabilities in your System Architecture. Because your system architecture is unique and has its own set of requirements, Network configuration should always be handled by your designated System or Network Administrator.
Diagnosing Usage Log Server Connectivity
Important Note: For diagnosing Usage Log Server Connectivity Behavior, we recommend using a Network Utility Tool, such as Netcat, to determine which of your ports are open or closed. Often times, one or more ports may be disabled, causing communication with the Usage Log Server to be blocked.
To resolve Usage Log Server Connectivity Behaviors, please try the following steps:
- Running the ncat command
nc -zv usage-logs.facetec.com 443(for https connections). - Running the ncat command
nc -zv logs.facetec.com 22(for sftp connections). - Reviewing FaceTec’s Port Configurations Table to ensure the necessary ports are accessible.
- Running “curl <USAGE_LOG_SERVER_IP>:<port>/health” to verify ULS is up and running.
- Checking the ULS Logs (/facetec-usage-logs/server/logs.txt) for errors.”
If a connection is refused or dropped during these steps, then a port is likely being blocked (usually by a Firewall Rule or a Network Setting). As this may be directly or indirectly correlated to Your Usage Log Server Network, you should notify Your System or Network Administrator, so they may further investigate this behavior.
Other Troubleshooting Options
Network error: Connection refused
- This usually means the FaceTec Server cannot connect to the hosted Usage Log Server in your network.
- Confirm the hosted usage log server is running by checking the health endpoint (Ex. http://[IP Address or URL]:3000/health).
- SSH into the FaceTec Server and make sure you can connect to the Usage Log Server (curl http://[IP Address or URL]:3000/health).
- Checking the ULS Logs (/facetec-usage-logs/server/logs.txt) for errors.
Permission denied (public key)
- Confirm you have uploaded the public key to the Account Page.
- Confirm you have added the private key to the computer that will be performing the transfer.
- Confirm the private key has the correct permissions (Article on configuring SSH Keys).
- When connecting with SFTP or your transfer tool, run it in debug mode to identify the exact error.