skyd

Basic skyd function checks

The siac tools is a very helpful command line tool for interacting with the skyc instance and debugging.
Almost all commands have a standard and verbose output. To see the verbose output, pass the -v flag.
siac also has a global -h flag for help on any command.

siac

Example
docker exec sia siac
Consensus:
Synced: Yes
Height: 369352
Wallet:
Status: unlocked
Siacoin Balance: 66.5 KS
Renter:
File Summary:
Files: 78376
Total Stored: 708.597 GB
Total Renewing Data: 5.3219 TB
Repair Status:
Last Health Check: 1437m
Repair Data Remaining: 62.91 MB
Stuck Repair Remaining: 25.615 GB
Stuck Chunks: 1233
Max Health: 69.44%
Min Redundancy: 1.90
Lost Files: 0
Contract Summary:
Renew Window (days): renewing
Renew Window (blocks): 2998 Blocks until Renew
Current Period Start: 368030
Next Period Start: 376670
Renew Window Start: 372350
Active Contracts: 50
Passive Contracts: 200
Disabled Contracts: 377
Key Information
  • Concensus
    • Here we want to ensure that the node is Synced: Yes
    • If the node is not synced, then you need to give it time to finished syncing.
    • You can use the siac consensus command for a detailed view on the status of the syncing
  • Wallet
    • Here we want to ensure that the wallet is Status: unlocked
    • If the wallet is locked, then many of the key actions can't be performed.
    • Unlock your wallet with siac wallet unlock
    • Additionally, ensure that your node is sufficiently funded.
  • Renter

siac renter

Example
docker exec sia siac renter
Allowance: 14.4 KS
Spent Funds: 5.118 KS
Unspent Funds: 9.282 KS
File Summary:
Files: 78376
Total Stored: 708.597 GB
Total Renewing Data: 5.3219 TB
Repair Status:
Last Health Check: 1437m
Repair Data Remaining: 50.33 MB
Stuck Repair Remaining: 25.615 GB
Stuck Chunks: 1233
Max Health: 69.44%
Min Redundancy: 1.90
Lost Files: 0
Contract Summary:
Renew Window (days): renewing
Renew Window (blocks): 2998 Blocks until Renew
Current Period Start: 368030
Next Period Start: 376670
Renew Window Start: 372350
Active Contracts: 50
Passive Contracts: 200
Disabled Contracts: 377
Almost all siac commands have an optional -v flag for verbose output. Here is an example of the verbose output for siac renter
docker exec sia siac renter -v
Allowance: 14.4 KS
Spent Funds: 5.118 KS
Unspent Funds: 9.282 KS
Spending:
Current Period Spending:
Spent Funds: 5.118 KS
Storage: 2.114 KS
Upload: 83.93 SC
Download: 0 H
FundAccount: 1.583 KS (+278.9 SC residue)
Balance: 449.9 SC (-137.2 KS drift)
DownloadsCost: 765.9 SC
MiscCost: 829.1 mS
RegistryReadsCost: 227.3 SC
RegistryWritesCost: 800.4 mS
RepairsCost: 202.1 SC
SubscriptionsCost: 0 H
UploadsCost: 0 H
Drift: -342.7 SC
Maintenance: 3495784 H
AccountBalanceCost: 117613 H
FundAccountCost: 6246 H
UpdatePriceTableCost: 3371925 H
Fees: 1.337 KS
ContractFees: 110.1 SC
SiafundFees: 1.023 KS
TransactionFees: 204.3 SC
Unspent Funds: 9.282 KS
Allocated: 6.033 KS
Unallocated: 3.249 KS
Skynet Fee: 0 H
File Summary:
Files: 78376
Total Stored: 708.597 GB
Total Renewing Data: 5.3219 TB
Repair Status:
Last Health Check: 1437m
Repair Data Remaining: 188.74 MB
Stuck Repair Remaining: 25.665 GB
Stuck Chunks: 1233
Max Health: 69.44%
Min Redundancy: 1.90
Lost Files: 0
Contract Summary:
Renew Window (days): renewing
Renew Window (blocks): 2998 Blocks until Renew
Current Period Start: 368030
Next Period Start: 376670
Renew Window Start: 372350
Active Contracts: 50
Passive Contracts: 200
Disabled Contracts: 377
Memory Status User Download User Upload Registry System Total
Available Memory 536.9 MB 1.074 GB 536.9 MB 507.5 MB 2.655 GB
Starting Memory 536.9 MB 1.074 GB 536.9 MB 1.611 GB 3.758 GB
Requested Memory 0 B 0 B 0 B 0 B 0 B
Available Priority Memory 536.9 MB 1.074 GB 536.9 MB 1.044 GB 3.192 GB
Starting Priority Memory 536.9 MB 1.074 GB 536.9 MB 2.147 GB 4.295 GB
Requested Priority Memory 0 B 0 B 0 B 0 B 0 B
Uploads Status
Paused: No
Pause End Time: 0s
Rate limits:
Download Speed: no limit
Upload Speed: no limit
Key Informatoin
  • Allowance
    • For the allowance we want to check the unspent unallocated. These are the funds available to form new contracts. If this is below 500SC you might experience problems forming contracts. Fix this by increasing your allowance.
  • Unspent Funds: 9.282 KS
    Allocated: 6.033 KS
    Unallocated: 3.249 KS
  • File Summary
    • This gives an overview of the size of the node
  • Repair Status
    • This gives an overview of how the node is doing keeping the files healthy
  • Contract Summary
    • This gives an overview of the status of the renter's contracts

Profiling

Sometimes where debugging skyd it is useful to get a CPU or a memory profile. These can be started and stopped with siac
docker exec sia siac profile -h
Start and stop CPU, memory, and/or trace profiles for the daemon
Usage:
siac profile [flags]
siac profile [command]
Available Commands:
start Start the profile for the daemon
stop Stop profiles for the daemon
Depending on the type of profile you need to run, you can use the appropriate flag:
docker exec sia siac profile start -h
Start a CPU, memory, and/or trace profile for the daemon by using
the corresponding flag. Provide a profileDir to save the profiles to. If no
profileDir is provided the profiles will be saved in the default profile
directory in the siad data directory.
Usage:
siac profile start [flags]
Flags:
-c, --cpu Start the CPU profile
-h, --help help for start
-m, --memory Start the Memory profile
--profileDir string Specify the directory where the profile logs are to be saved
-t, --trace Start the Trace profile
Last modified 4d ago
Copy link
Outline
Basic skyd function checks
siac
siac renter
Profiling