[{"data":1,"prerenderedAt":491},["ShallowReactive",2],{"navigation":3,"\u002Foperations\u002Fmonitoring":194,"\u002Foperations\u002Fmonitoring-surround":486},[4,18,31,64,81,102,111,132,149],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting started","\u002Fgetting-started","1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Run your first workflow","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Core concepts","\u002Fconcepts","2.concepts",[23,27],{"title":24,"path":25,"stem":26},"The platform model","\u002Fconcepts\u002Fplatform","2.concepts\u002F1.platform",{"title":28,"path":29,"stem":30},"Architecture and boundaries","\u002Fconcepts\u002Farchitecture","2.concepts\u002F2.architecture",{"title":32,"path":33,"stem":34,"children":35,"page":17},"Installation","\u002Finstallation","3.installation",[36,40,44,48,52,56,60],{"title":37,"path":38,"stem":39},"Overview and requirements","\u002Finstallation\u002Foverview","3.installation\u002F1.overview",{"title":41,"path":42,"stem":43},"Local evaluation","\u002Finstallation\u002Flocal-evaluation","3.installation\u002F2.local-evaluation",{"title":45,"path":46,"stem":47},"Install the server","\u002Finstallation\u002Fserver","3.installation\u002F3.server",{"title":49,"path":50,"stem":51},"Install a runner","\u002Finstallation\u002Frunner","3.installation\u002F4.runner",{"title":53,"path":54,"stem":55},"Verify the installation","\u002Finstallation\u002Fverification","3.installation\u002F5.verification",{"title":57,"path":58,"stem":59},"Upgrade the platform","\u002Finstallation\u002Fupgrades","3.installation\u002F6.upgrades",{"title":61,"path":62,"stem":63},"Guided installer","\u002Finstallation\u002Finstaller","3.installation\u002F7.installer",{"title":65,"path":66,"stem":67,"children":68,"page":17},"Build workflows","\u002Fworkflows","4.workflows",[69,73,77],{"title":70,"path":71,"stem":72},"Build a Definition","\u002Fworkflows\u002Fdefinitions","4.workflows\u002F0.definitions",{"title":74,"path":75,"stem":76},"Deploy and run workflows","\u002Fworkflows\u002Fruns","4.workflows\u002F1.runs",{"title":78,"path":79,"stem":80},"Inputs, context, and secrets","\u002Fworkflows\u002Finputs-and-secrets","4.workflows\u002F2.inputs-and-secrets",{"title":82,"path":83,"stem":84,"children":85,"page":17},"Run and recover","\u002Foperations","5.operations",[86,90,94,98],{"title":87,"path":88,"stem":89},"Monitor Runs","\u002Foperations\u002Fmonitoring","5.operations\u002F1.monitoring",{"title":91,"path":92,"stem":93},"Approve prepared steps","\u002Foperations\u002Fapprovals","5.operations\u002F2.approvals",{"title":95,"path":96,"stem":97},"Recover or cancel execution","\u002Foperations\u002Frecovery","5.operations\u002F3.recovery",{"title":99,"path":100,"stem":101},"Troubleshooting","\u002Foperations\u002Ftroubleshooting","5.operations\u002F4.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"Action catalog","\u002Fcatalog","6.catalog",[107],{"title":108,"path":109,"stem":110},"Find and use Actions","\u002Fcatalog\u002Foverview","6.catalog\u002F1.overview",{"title":112,"path":113,"stem":114,"children":115,"page":17},"Administration","\u002Fadministration","7.administration",[116,120,124,128],{"title":117,"path":118,"stem":119},"Registries and Environments","\u002Fadministration\u002Fenvironments","7.administration\u002F2.environments",{"title":121,"path":122,"stem":123},"Manage runners","\u002Fadministration\u002Frunners","7.administration\u002F3.runners",{"title":125,"path":126,"stem":127},"Access and approval policies","\u002Fadministration\u002Faccess","7.administration\u002F4.access",{"title":129,"path":130,"stem":131},"Backups and upgrades","\u002Fadministration\u002Fmaintenance","7.administration\u002F5.maintenance",{"title":133,"path":134,"stem":135,"children":136,"page":17},"Develop Actions","\u002Factions","8.actions",[137,141,145],{"title":138,"path":139,"stem":140},"Build your first Action","\u002Factions\u002Fquickstart","8.actions\u002F1.quickstart",{"title":142,"path":143,"stem":144},"Local development","\u002Factions\u002Flocal-development","8.actions\u002F2.local-development",{"title":146,"path":147,"stem":148},"Publish an Action","\u002Factions\u002Fpublishing","8.actions\u002F3.publishing",{"title":150,"path":151,"stem":152,"children":153,"page":17},"Reference","\u002Freference","9.reference",[154,158,162,166,170,174,178,182,186,190],{"title":155,"path":156,"stem":157},"Operator CLI","\u002Freference\u002Foperator-cli","9.reference\u002F1.operator-cli",{"title":159,"path":160,"stem":161},"Installer CLI","\u002Freference\u002Finstaller-cli","9.reference\u002F10.installer-cli",{"title":163,"path":164,"stem":165},"Definition syntax","\u002Freference\u002Fdefinition","9.reference\u002F2.definition",{"title":167,"path":168,"stem":169},"CLI configuration","\u002Freference\u002Fconfiguration","9.reference\u002F3.configuration",{"title":171,"path":172,"stem":173},"API integration","\u002Freference\u002Fapi","9.reference\u002F4.api",{"title":175,"path":176,"stem":177},"Action CLI","\u002Freference\u002Faction-cli","9.reference\u002F5.action-cli",{"title":179,"path":180,"stem":181},"Action SDK","\u002Freference\u002Fsdk","9.reference\u002F6.sdk",{"title":183,"path":184,"stem":185},"Contracts and compatibility","\u002Freference\u002Fcontracts","9.reference\u002F7.contracts",{"title":187,"path":188,"stem":189},"Server configuration","\u002Freference\u002Fserver-configuration","9.reference\u002F8.server-configuration",{"title":191,"path":192,"stem":193},"Runner configuration","\u002Freference\u002Frunner-configuration","9.reference\u002F9.runner-configuration",{"id":195,"title":87,"body":196,"description":480,"extension":481,"meta":482,"navigation":483,"path":88,"seo":484,"stem":89,"__hash__":485},"docs\u002F5.operations\u002F1.monitoring.md",{"type":197,"value":198,"toc":474},"minimark",[199,204,213,243,261,265,375,388,394,398,430,437,440,444,451,470],[200,201,203],"h2",{"id":202},"follow-current-execution","Follow current execution",[205,206,207,208,212],"p",{},"Use your Run ID in place of ",[209,210,211],"code",{},"42",":",[214,215,221],"pre",{"className":216,"code":217,"filename":218,"language":219,"meta":220,"style":220},"language-sh shiki shiki-themes pyplines-light pyplines-light pyplines-dark","pyplines run list --environment production\npyplines run status 42 --watch\npyplines run info 42\n","Terminal","sh","",[209,222,223,231,237],{"__ignoreMap":220},[224,225,228],"span",{"class":226,"line":227},"line",1,[224,229,230],{},"pyplines run list --environment production\n",[224,232,234],{"class":226,"line":233},2,[224,235,236],{},"pyplines run status 42 --watch\n",[224,238,240],{"class":226,"line":239},3,[224,241,242],{},"pyplines run info 42\n",[205,244,245,248,249,252,253,256,257,260],{},[209,246,247],{},"status"," summarizes progress; ",[209,250,251],{},"info"," includes available inputs, outputs, images, errors, and invocation details. Global ",[209,254,255],{},"--json"," goes before the command: ",[209,258,259],{},"pyplines --json run info 42",".",[200,262,264],{"id":263},"understand-the-run-state","Understand the Run state",[266,267,268,281],"table",{},[269,270,271],"thead",{},[272,273,274,278],"tr",{},[275,276,277],"th",{},"State",[275,279,280],{},"Meaning and next action",[282,283,284,295,305,315,325,335,345,355,365],"tbody",{},[272,285,286,292],{},[287,288,289],"td",{},[209,290,291],{},"preparing",[287,293,294],{},"The server is resolving inputs and checking requirements.",[272,296,297,302],{},[287,298,299],{},[209,300,301],{},"awaiting_approval",[287,303,304],{},"A prepared step needs eligible approvals. Inspect it before approving.",[272,306,307,312],{},[287,308,309],{},[209,310,311],{},"queued",[287,313,314],{},"Work is waiting for the Environment, runner connectivity, capacity, or container startup. Read the diagnostic.",[272,316,317,322],{},[287,318,319],{},[209,320,321],{},"running",[287,323,324],{},"Container execution has been observed.",[272,326,327,332],{},[287,328,329],{},[209,330,331],{},"blocked",[287,333,334],{},"A step cannot proceed, including after an Action failure. Investigate before recovery.",[272,336,337,342],{},[287,338,339],{},[209,340,341],{},"uncertain",[287,343,344],{},"The server cannot establish that execution has stopped. Restore the owning runner's connectivity.",[272,346,347,352],{},[287,348,349],{},[209,350,351],{},"cancelling",[287,353,354],{},"Stop has been requested but execution has not yet settled.",[272,356,357,362],{},[287,358,359],{},[209,360,361],{},"cancelled",[287,363,364],{},"The Run has stopped. Prior external effects remain.",[272,366,367,372],{},[287,368,369],{},[209,370,371],{},"succeeded",[287,373,374],{},"The workflow has completed successfully.",[205,376,377,378,380,381,383,384,387],{},"Only ",[209,379,361],{}," and ",[209,382,371],{}," are terminal. A failed Action blocks its Run; the overall Run does not use a separate ",[209,385,386],{},"failed"," terminal state.",[205,389,390,391,260],{},"Run duration includes waiting and approvals. Step duration measures the latest attempt's observed container execution. Unknown historical timing displays ",[209,392,393],{},"-",[200,395,397],{"id":396},"inspect-attempts-history-and-logs","Inspect attempts, history, and logs",[214,399,401],{"className":216,"code":400,"filename":218,"language":219,"meta":220,"style":220},"pyplines run attempts 42\npyplines run history 42\npyplines run logs 42 inspect\n# Replace INVOCATION_ID with an invocation from the attempts response.\npyplines run logs 42 inspect --attempt INVOCATION_ID\n",[209,402,403,408,413,418,424],{"__ignoreMap":220},[224,404,405],{"class":226,"line":227},[224,406,407],{},"pyplines run attempts 42\n",[224,409,410],{"class":226,"line":233},[224,411,412],{},"pyplines run history 42\n",[224,414,415],{"class":226,"line":239},[224,416,417],{},"pyplines run logs 42 inspect\n",[224,419,421],{"class":226,"line":420},4,[224,422,423],{},"# Replace INVOCATION_ID with an invocation from the attempts response.\n",[224,425,427],{"class":226,"line":426},5,[224,428,429],{},"pyplines run logs 42 inspect --attempt INVOCATION_ID\n",[205,431,432,433,436],{},"Use the actual step name in place of ",[209,434,435],{},"inspect",". Attempts retain invocation identity, runner, outcome, exit code, and timing. History records events and decisions. After a retry, select the earlier invocation to investigate its output.",[205,438,439],{},"Logs are bounded and may be truncated. Private steps suppress logs and withhold results from ordinary reads. Use attempt state and recorded errors to distinguish a private result from missing execution.",[200,441,443],{"id":442},"when-a-run-is-waiting","When a Run is waiting",[205,445,446,447,450],{},"Read the Run diagnostic first. One Environment executes one Run's attempt at a time, so another Run may legitimately hold its execution slot. An administrator can use ",[209,448,449],{},"pyplines runner list"," to inspect connectivity and admission. After a server restart, connectivity is unknown until the next runner heartbeat.",[205,452,453,454,457,458,462,463,466,467,260],{},"A CLI wait timeout does not cancel execution. Reconnect with ",[209,455,456],{},"run status ID --watch"," rather than starting duplicate work. Continue with ",[459,460,461],"a",{"href":92},"approvals",", ",[459,464,465],{"href":96},"recovery",", or ",[459,468,469],{"href":100},"troubleshooting",[471,472,473],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":220,"searchDepth":233,"depth":233,"links":475},[476,477,478,479],{"id":202,"depth":233,"text":203},{"id":263,"depth":233,"text":264},{"id":396,"depth":233,"text":397},{"id":442,"depth":233,"text":443},"Follow execution and inspect the evidence for each step and attempt.","md",{},true,{"title":87,"description":480},"GOZDX3crvVBGIpHl-kYpaa-BgESZmXUFlg_T5U2KHds",[487,489],{"title":78,"path":79,"stem":80,"description":488,"children":-1},"Bind operational parameters and environment-specific values without embedding credentials in YAML.",{"title":91,"path":92,"stem":93,"description":490,"children":-1},"Review the exact work authorized by an approval.",1792213696161]