メニュー
Views, downloads, and searches application and job logs from TrueFoundry. Supports time-range filtering, pod filtering, and error search.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | truefoundry-logs |
| description | Views, downloads, and searches application and job logs from TrueFoundry. Supports time-range filtering, pod filtering, and error search. |
| license | MIT |
| compatibility | Requires Bash, curl, and access to a TrueFoundry instance |
| allowed-tools | Bash(*/tfy-api.sh *) |
Routing note: For ambiguous user intents, use the shared clarification templates in references/intent-clarification.md.
View and download application and job logs from TrueFoundry.
View, download, and search application and job logs from TrueFoundry. Useful for debugging deployments, checking startup output, and finding errors.
Security: Log output may contain sensitive data (secrets, tokens, PII). Do not forward raw logs to external services or include them in responses without reviewing for sensitive content first.
When using direct API, set TFY_API_SH to the full path of this skill's scripts/tfy-api.sh. See references/tfy-api-setup.md for paths per agent.
tfy_logs_download(payload={
"workspace_id": "ws-id",
"application_fqn": "app-fqn",
"start_ts": "2026-02-10T00:00:00Z",
"end_ts": "2026-02-10T23:59:59Z"
})
# Set the path to tfy-api.sh for your agent (example for Claude Code):
TFY_API_SH=~/.claude/skills/truefoundry-logs/scripts/tfy-api.sh
# Download logs for an app in a workspace
$TFY_API_SH GET '/api/svc/v1/logs/WORKSPACE_ID/download?applicationFqn=APP_FQN&startTs=START&endTs=END'
# With search filter
$TFY_API_SH GET '/api/svc/v1/logs/WORKSPACE_ID/download?applicationId=APP_ID&searchString=error&searchType=contains'
| Parameter | API Key | Description |
|---|---|---|
workspace_id | (path) | Workspace ID (required) |
application_id | applicationId | Filter by app ID |
application_fqn | applicationFqn | Filter by app FQN |
deployment_id | deploymentId | Filter by deployment |
job_run_name | jobRunName | Filter by job run |
start_ts | startTs | Start timestamp (ISO 8601) |
end_ts | endTs | End timestamp (ISO 8601) |
search_string | searchString | Search within logs |
search_type | searchType | contains, regex |
pod_name | podName | Filter by pod |
Show logs in chronological order. For long output, show the last N lines or summarize errors:
Logs for tfy-tool-server (last 20 lines):
2026-02-10 14:30:01 INFO Server starting on port 8000
2026-02-10 14:30:02 INFO Tools endpoint ready at /tools
2026-02-10 14:30:05 INFO Health check: OK
<success_criteria>
</success_criteria>
applications skill to get app ID or FQNworkspaces skill to get workspace IDsearchString=errorworkspace_id is required for log downloads.
Use the workspaces skill to find your workspace ID.
No logs found for the given filters. Check:
- Time range is correct
- Application ID/FQN is correct
- The app has actually run during this period
Cannot access logs. Check your API key permissions for this workspace.
Manages TrueFoundry roles, teams, and collaborators. Create custom roles, organize users into teams, and grant access to resources. Use when managing permissions, creating teams, or adding collaborators.
Manages TrueFoundry personal access tokens (PATs). List, create, and delete tokens for API auth and CI/CD.
Lists, inspects, and manages TrueFoundry application deployments. Shows status, health, and details for services, jobs, and Helm releases. Also handles requests to delete, remove, or destroy applications by directing users to the TrueFoundry UI.
Deploys applications to TrueFoundry. Handles single HTTP services, async/queue workers, multi-service projects, and declarative manifest apply. Supports `tfy apply`, `tfy deploy`, docker-compose translation, and CI/CD pipelines. Use when deploying apps, applying manifests, shipping services, or orchestrating multi-service deployments.
Fetches TrueFoundry documentation, API reference, and deployment guides. Use when the user needs platform docs or how-to guidance.
Sets up GitOps CI/CD pipelines for TrueFoundry using tfy apply. Supports GitHub Actions, GitLab CI, and Bitbucket Pipelines.