Your Developer Satellite runs in a Docker container. To view the Docker logs, run
docker logs lightstep_developer_satellite
If you receive output such as
Error: No such container: lightstep_developer_satellite, this most likely means the local Developer Satellite is not running.
The tail end of the logs should show
Self-Test Status: SUCCESS and no errors:
1 2 3 4 5 6 7 8 9 10 11 12 13 I0723 18:04:12.758873] Satellite Self-Test Results... API Key authorized for: 1 Organizations [YourOrganization] 1 Projects [abc123...xyz890] 1 Access Tokens [1ef418f3...] 0 Disabled Access Tokens  Tests: Connected to api-grpc.lightstep.com:8043: success Require unique port numbers: success Self-Test Status: SUCCESS
Connection Errors from the Tracer
- Confirm your Developer Satellite is running.
Check the Satellite’s status in the top left of the Developer Mode display. It should say Running.
If instead it says Not Running, run the install script again.
Confirm that you configured your tracer correctly with the following values (see language-specific tracer] initialization syntax):
1 2 3 4
host: localhost port: 8360 plaintext: true access_token: developer
If no spans are appearing, try enabling more verbose output from the client-side, to see if there are syntax/compilation/connectivity errors, etc.
If you still have issues, contact our Customer Success team.
App in Docker Can’t Access the Developer Satellite
Confirm that the Developer Satellite is running on the same Docker network as your service containers.
docker inspect -f
lightstep_developer_satelliteto get the IP address of the Developer Satellite Container.
- Use this IP as the
hostname in your tracer configuration (instead of
Not Seeing My Spans (No Errors Reported)
- Enable verbose client-side logging based on tracer language-specific settings.
- Confirm tracer initialization settings point to the local Developer Satellite and not a remote Satellite.
- Confirm the
- Close your tracer before exiting.
- Attempt another quick sample tracer app as found in the Quick Start: Instrumentation.