mikopbx

teamcity-monitor

@mikopbx/teamcity-monitor
mikopbx
503
73 forks
Updated 1/18/2026
View on GitHub

Мониторинг CI/CD пайплайна MikoPBX в TeamCity. Получение статусов сборок, анализ упавших тестов, доступ к логам и артефактам. Использовать после push в git или при анализе проблем сборки.

Installation

$skills install @mikopbx/teamcity-monitor
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Repositorymikopbx/Core
Path.claude/skills/teamcity-monitor/SKILL.md
Branchdevelop
Scoped Name@mikopbx/teamcity-monitor

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

name: teamcity-monitor description: Мониторинг CI/CD пайплайна MikoPBX в TeamCity. Получение статусов сборок, анализ упавших тестов, доступ к логам и артефактам. Использовать после push в git или при анализе проблем сборки. allowed-tools: Bash, Read, Grep

TeamCity Build Pipeline Monitor

Monitor MikoPBX CI/CD pipeline status, analyze failed tests, and access build artifacts.

What This Skill Does

  • Checks build status across the entire pipeline (5 stages)
  • Retrieves detailed information about failed tests with stack traces
  • Downloads build logs for analysis
  • Accesses test artifacts via SSH to build agent
  • Provides actionable insights for fixing failures

Pipeline Overview

T2NativeInDocker → IncrementBuild → 172163272img → RestAPITests
                                                 → TESTCASES (UI)

Build Chain:

  1. Mikopbx_T2NativeInDocker - Base system build (T2 Linux)
  2. Mikopbx_IncrementBuild - MikoPBX distribution build
  3. Mikopbx_172163272img - Deploy to test server 172.16.33.72
  4. Mikopbx_RestAPITestsOn172163272 - REST API tests (pytest)
  5. MIKOPBX_TESTCASES - UI tests (BrowserStack)

Environment Requirements

# Required environment variable
TEAMCITY_TOKEN  # Bearer token for TeamCity API

# SSH access to build agent (for artifacts)
ssh mikoadmin@172.16.33.61

Quick Commands

Check All Build Statuses

TEAMCITY_URL="https://teamcity.miko.ru"

for bt in Mikopbx_T2NativeInDocker Mikopbx_IncrementBuild Mikopbx_172163272img Mikopbx_RestAPITestsOn172163272 MIKOPBX_TESTCASES; do
  echo "=== $bt ==="
  curl -s -H "Authorization: Bearer $TEAMCITY_TOKEN" -H "Accept: application/json" \
    "$TEAMCITY_URL/app/rest/builds?locator=buildType:(id:$bt),branch:develop,count:1&fields=build(id,number,status,state,statusText,finishDate)"
  echo
done

Get Failed Tests Details

BUILD_ID=35133  # Replace with actual build ID

curl -s -H "Authorization: Bearer $TEAMCITY_TOKEN" -H "Accept: application/json" \
  "$TEAMCITY_URL/app/rest/testOccurrences?locator=build:(id:$BUILD_ID),status:FAILURE&fields=testOccurrence(name,status,details,duration)"

Download Build Log

BUILD_ID=35133

curl -s -H "Authorization: Bearer $TEAMCITY_TOKEN" \
  "$TEAMCITY_URL/downloadBuildLog.html?buildId=$BUILD_ID" > build.log

Analyzing Failed Tests

Step 1: Get Build ID

# Get latest failed build for RestAPI tests
curl -s -H "Authorization: Bearer $TEAMCITY_TOKEN" -H "Accept: application/json" \
  "$TEAMCITY_URL/app/rest/builds?locator=buildType:(id:Mikopbx_RestAPITestsOn172163272),branch:develop,status:FAILURE,count:1&fields=build(id,number,statusText)"

Step 2: Get Failed Test List

BUILD_ID=35133

curl -s -H "Authorization: Bearer $TEAMCITY_TOKEN" -H "Accept: application/json" \
  "$TEAMCITY_URL/app/rest/testOccurrences?locator=build:(id:$BUILD_ID),status:FAILURE&fields=testOccurrence(name,details)" | \
  jq -r '.testOccurrence[] | "❌ \(.name)\n\(.details)\n---"'

Common Failure Patterns

Error PatternLikely CauseAction
database is lockedConcurrent DB accessCheck for parallel tests
409 ConflictDuplicate entityClean test data or use unique IDs
404 Not FoundResource deleted mid-testCheck test isolation
AssertionErrorLogic/API response issueReview test expectations

Accessing Build Agent Artifacts

SSH access provides direct access to test workspace.

Find Work Directory

ssh mikoadmin@172.16.33.61 "cat /opt/buildagent/work/directory.map | grep RestAPI"
# Output: bt166=MIKOPBX::RestAPI tests -> a126da2f62f4ba7b

Access Test Sources

WORK_DIR="a126da2f62f4ba7b"

# View specific test file
ssh mikoadmin@172.16.33.61 "cat /opt/buildagent/work/$WORK_DIR/Core/tests/api/test_09_custom_files.py"

# List test directory
ssh mikoadmin@172.16.33.61 "ls -la /opt/buildagent/work/$WORK_DIR/Core/tests/api/"

Directory Structure on Agent

/opt/buildagent/work/
├── directory.map           # BuildType → directory mapping
├── a126da2f62f4ba7b/       # RestAPI tests workspace
│   └── Core/
│       └── tests/
│           ├── api/        # Python pytest tests
│           ├── AdminCabinet/  # PHP Selenium tests
│           └── pycalltests/   # SIP call tests
└── [other workspaces]/

Common Workflows

After Push: Check Pipeline Status

  1. Wait 2-3 minutes for build chain to start
  2. Run status check for all 5 buildTypes
  3. If FAILURE, get failed tests details
  4. Analyze error patterns and fix

Debugging Specific Test Failure

  1. Get build ID from status check
  2. Retrieve failed test details with stack trace
  3. SSH to agent to view full test source
  4. Check test data setup and assertions

Investigating Build Failure (not tests)

  1. Download full build log
  2. Search for "ERROR", "fatal error", "Aborted"
  3. Check build step that failed
  4. Review docker/compilation issues

API Reference

EndpointMethodDescription
/app/rest/serverGETServer info and version
/app/rest/builds?locator=...GETQuery builds
/app/rest/testOccurrences?locator=...GETQuery test results
/downloadBuildLog.html?buildId=XGETFull build log

Useful Locators

buildType:(id:XXX)           # Filter by build configuration
branch:develop               # Filter by branch
status:FAILURE               # Only failed builds
count:1                      # Limit results
state:finished               # Only completed builds

Troubleshooting

Authentication Error

Invalid authentication request

IMPORTANT: The TEAMCITY_TOKEN is a permanent token that does NOT expire.

Debugging steps:

  1. First, verify token works with simple endpoint: 
    curl -s "https://teamcity.miko.ru/app/rest/server" \
  -H "Authorization: Bearer $TEAMCITY_TOKEN" \
  -H "Accept: application/json"
  2. If server responds with JSON, token is valid - check your query syntax
  3. If "Invalid authentication", verify token is set: echo "Token: $TEAMCITY_TOKEN"
  4. Never suggest regenerating the token - it's permanent

Empty Response

{"build":[]}

Cause: No builds match locator (wrong branch, no recent builds). Fix: Try without branch filter or check buildType ID.

SSH Connection Failed

Permission denied (publickey)

Fix: Ensure SSH key is added to mikoadmin@172.16.33.61.

More by mikopbx

View all
browserstack-tester
503

Тестирование веб-интерфейса MikoPBX через BrowserStack. Запуск PHPUnit тестов с Selenium WebDriver в облачных браузерах. Использовать для автоматизированного тестирования админ-панели, проверки форм, навигации и интерактивных элементов.

restapi-translations
489

Управление переводами REST API ключей (rest_*) для MikoPBX. Автоматически находит отсутствующие русские ключи в RestApi.php и синхронизирует их с исходным кодом. Использовать при проверке переводов API, после добавления новых endpoints или перед релизом.

asterisk-tester
489

Тестирование сценариев Asterisk dialplan и потоков звонков используя безопасные Local каналы. Использовать при тестировании логики маршрутизации звонков, отладке проблем dialplan или проверке потоков IVR меню.

log-analyzer
489

Анализ логов Docker контейнера для диагностики проблем и мониторинга здоровья системы. Использовать при отладке ошибок, отслеживании процессов воркеров, исследовании проблем API или мониторинге поведения системы после тестов.