sfctl partition
Query's uitvoeren en partities beheren voor elke service.
Opdracht
| Opdracht | Beschrijving |
|---|---|
| gegevensverlies | Deze API veroorzaakt gegevensverlies voor de opgegeven partitie. |
| status van gegevensverlies | Hiermee haalt u de voortgang van een partitiegegevensverliesbewerking op met behulp van de StartDataLoss-API. |
| gezondheidszorg | Hiermee haalt u de status van de opgegeven Service Fabric-partitie op. |
| Info | Haalt de informatie op over een Service Fabric-partitie. |
| lijst | Hiermee haalt u de lijst met partities van een Service Fabric-service op. |
| laden | Hiermee haalt u de laadgegevens van de opgegeven Service Fabric-partitie op. |
| load-reset | Hiermee wordt de huidige belasting van een Service Fabric-partitie opnieuw ingesteld. |
| quorumverlies | Veroorzaakt quorumverlies voor een bepaalde stateful servicepartitie. |
| quorum-verliesstatus | Hiermee haalt u de voortgang van een quorumverliesbewerking op een partitie op met behulp van de StartQuorumLoss-API. |
| herstellen | Geeft aan dat het Service Fabric-cluster moet proberen een specifieke partitie te herstellen die momenteel vastzit in quorumverlies. |
| alles herstellen | Geeft aan dat het Service Fabric-cluster moet proberen alle services (inclusief systeemservices) te herstellen die momenteel vastzitten in quorumverlies. |
| rapportstatus | Hiermee wordt een statusrapport verzonden op de Service Fabric-partitie. |
| restart | Met deze API worden sommige of alle replica's of exemplaren van de opgegeven partitie opnieuw gestart. |
| herstartstatus | Hiermee wordt de voortgang van een PartitionRestart-bewerking gestart met StartPartitionRestart. |
| svc-name | Hiermee haalt u de naam op van de Service Fabric-service voor een partitie. |
sfctl partitioneren gegevensverlies
Deze API veroorzaakt gegevensverlies voor de opgegeven partitie.
Er wordt een aanroep naar de OnDataLossAsync-API van de partitie geactiveerd. Deze API veroorzaakt gegevensverlies voor de opgegeven partitie. Hiermee wordt een aanroep naar de OnDataLoss-API van de partitie geactiveerd. Het werkelijke gegevensverlies is afhankelijk van de opgegeven DataLossMode.
- PartialDataLoss: Alleen een quorum van replica's wordt verwijderd en OnDataLoss wordt geactiveerd voor de partitie, maar het werkelijke gegevensverlies is afhankelijk van de aanwezigheid van replicatie tijdens de vlucht.
- FullDataLoss: alle replica's worden verwijderd, waardoor alle gegevens verloren gaan en OnDataLoss wordt geactiveerd. Deze API mag alleen worden aangeroepen met een stateful service als doel. Het aanroepen van deze API met een systeemservice omdat het doel niet wordt geadviseerd.
Notitie
Zodra deze API is aangeroepen, kan deze niet worden omgekeerd. Het aanroepen van CancelOperation stopt de uitvoering en schoont de interne systeemstatus op. Er worden geen gegevens hersteld als de opdracht ver genoeg is uitgevoerd om gegevensverlies te veroorzaken. Roep de GetDataLossProgress-API aan met dezelfde OperationId om informatie te retourneren over de bewerking die met deze API is gestart.
Argumenten
| Argument | Beschrijving |
|---|---|
| --data-loss-mode [vereist] | Deze opsomming wordt doorgegeven aan de StartDataLoss-API om aan te geven welk type gegevensverlies moet worden veroorzaakt. |
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition data-loss-status
Hiermee haalt u de voortgang van een partitiegegevensverliesbewerking op met behulp van de StartDataLoss-API.
Hiermee wordt de voortgang opgehaald van een bewerking voor gegevensverlies die is gestart met StartDataLoss, met behulp van de OperationId.
Argumenten
| Argument | Beschrijving |
|---|---|
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl-partitiestatus
Hiermee haalt u de status van de opgegeven Service Fabric-partitie op.
Gebruik EventsHealthStateFilter om de verzameling statusgebeurtenissen te filteren die zijn gerapporteerd op de service op basis van de status. Gebruik ReplicasHealthStateFilter om de verzameling ReplicaHealthState-objecten op de partitie te filteren. Als u een partitie opgeeft die niet bestaat in het statusarchief, retourneert deze aanvraag een fout.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --events-health-state-filter | Hiermee kunt u filteren op de verzameling HealthEvent-objecten die worden geretourneerd op basis van de status. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen gebeurtenissen die overeenkomen met het filter worden geretourneerd. Alle gebeurtenissen worden gebruikt om de geaggregeerde status te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd. De statuswaarden zijn opsomming op basis van vlaggen, dus de waarde kan een combinatie van deze waarden zijn, verkregen met behulp van de bitsgewijze OR-operator. Als de opgegeven waarde bijvoorbeeld 6 is, worden alle gebeurtenissen met de HealthState-waarde OK (2) en Waarschuwing (4) geretourneerd. - Standaardwaarde- Standaardwaarde. Komt overeen met elke HealthState. De waarde is nul. - Geen - Filter dat niet overeenkomt met een HealthState-waarde. Wordt gebruikt om geen resultaten te retourneren voor een bepaalde verzameling statussen. De waarde is 1. - OK- Filter dat overeenkomt met invoer met HealthState-waarde OK. De waarde is 2. - Waarschuwing: filter dat overeenkomt met invoer met HealthState-waardewaarschuwing. De waarde is 4. - Fout: filter dat overeenkomt met invoer met HealthState-waardeFout. De waarde is 8. - Alle - Filter dat overeenkomt met invoer met een HealthState-waarde. De waarde is 65535. |
| --exclude-health-statistics | Hiermee wordt aangegeven of de statusstatistieken moeten worden geretourneerd als onderdeel van het queryresultaat. Standaard onwaar. De statistieken geven het aantal onderliggende entiteiten weer in de status OK, Waarschuwing en Fout. |
| --replicas-health-state-filter | Hiermee kunt u de verzameling ReplicaHealthState-objecten filteren op de partitie. De waarde kan worden verkregen van leden of bitsgewijze bewerkingen voor leden van HealthStateFilter. Alleen replica's die overeenkomen met het filter worden geretourneerd. Alle replica's worden gebruikt om de geaggregeerde status te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd. De statuswaarden zijn opsomming op basis van vlaggen, zodat de waarde een combinatie van deze waarden kan zijn die worden verkregen met behulp van de operator bitwise OR. Als de opgegeven waarde bijvoorbeeld 6 is, worden alle gebeurtenissen met de HealthState-waarde OK (2) en Waarschuwing (4) geretourneerd. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. - Standaardwaarde- Standaardwaarde. Komt overeen met elke HealthState. De waarde is nul. - Geen - Filter dat niet overeenkomt met een HealthState-waarde. Wordt gebruikt om geen resultaten te retourneren voor een bepaalde verzameling statussen. De waarde is 1. - OK- Filter dat overeenkomt met invoer met HealthState-waarde OK. De waarde is 2. - Waarschuwing: filter dat overeenkomt met invoer met HealthState-waardewaarschuwing. De waarde is 4. - Fout: filter dat overeenkomt met invoer met HealthState-waardeFout. De waarde is 8. - Alle - Filter dat overeenkomt met invoer met een HealthState-waarde. De waarde is 65535. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl-partitiegegevens
Haalt de informatie op over een Service Fabric-partitie.
Hiermee haalt u de informatie over de opgegeven partitie op. Het antwoord bevat de partitie-id, partitioneringsschemagegevens, sleutels die worden ondersteund door de partitie, status, status en andere details over de partitie.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partitielijst
Hiermee haalt u de lijst met partities van een Service Fabric-service op.
Het antwoord bevat de partitie-id, partitioneringsschemagegevens, sleutels die worden ondersteund door de partitie, status, status en andere details over de partitie.
Argumenten
| Argument | Beschrijving |
|---|---|
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --vervolgtoken | De vervolgtokenparameter wordt gebruikt om de volgende set resultaten te verkrijgen. Een vervolgtoken met een niet-lege waarde wordt opgenomen in het antwoord van de API wanneer de resultaten van het systeem niet in één antwoord passen. Wanneer deze waarde wordt doorgegeven aan de volgende API-aanroep, retourneert de API de volgende set resultaten. Als er geen verdere resultaten zijn, bevat het vervolgtoken geen waarde. De waarde van deze parameter mag niet url-gecodeerd zijn. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl-partitiebelasting
Hiermee haalt u de laadgegevens van de opgegeven Service Fabric-partitie op.
Retourneert informatie over de belasting van een opgegeven partitie. Het antwoord bevat een lijst met laadrapporten voor een Service Fabric-partitie. Elk rapport bevat de naam, waarde en laatste gerapporteerde tijd in UTC.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition load-reset
Hiermee wordt de huidige belasting van een Service Fabric-partitie opnieuw ingesteld.
Hiermee stelt u de huidige belasting van een Service Fabric-partitie opnieuw in op de standaardbelasting voor de service.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition quorum-loss
Veroorzaakt quorumverlies voor een bepaalde stateful servicepartitie.
Deze API is handig voor een tijdelijke quorumverliessituatie in uw service. Roep de GetQuorumLossProgress-API aan met dezelfde OperationId om informatie te retourneren over de bewerking die met deze API is gestart. Dit kan alleen worden aangeroepen voor stateful persistente (HasPersistedState==true)-services. Gebruik deze API niet voor stateless services of stateful in-memory services.
Argumenten
| Argument | Beschrijving |
|---|---|
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --quorum-loss-duration [vereist] | De hoeveelheid tijd waarvoor de partitie wordt bewaard in quorumverlies. Dit moet in seconden worden opgegeven. |
| --quorum-loss-mode [vereist] | Deze opsomming wordt doorgegeven aan de StartQuorumLoss-API om aan te geven welk type quorumverlies moet worden veroorzaakt. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition quorum-loss-status
Hiermee haalt u de voortgang van een quorumverliesbewerking op een partitie op met behulp van de StartQuorumLoss-API.
Hiermee wordt de voortgang van een quorumverlies gestart met StartQuorumLoss met behulp van de opgegeven OperationId.
Argumenten
| Argument | Beschrijving |
|---|---|
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partitie herstellen
Geeft aan dat het Service Fabric-cluster moet proberen een specifieke partitie te herstellen die momenteel vastzit in quorumverlies.
Deze bewerking moet alleen worden uitgevoerd als bekend is dat de replica's die niet kunnen worden hersteld. Onjuist gebruik van deze API kan mogelijk gegevensverlies veroorzaken.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition recover-all
Geeft aan dat het Service Fabric-cluster moet proberen alle services (inclusief systeemservices) te herstellen die momenteel vastzitten in quorumverlies.
Deze bewerking moet alleen worden uitgevoerd als bekend is dat de replica's die niet kunnen worden hersteld. Onjuist gebruik van deze API kan mogelijk gegevensverlies veroorzaken.
Argumenten
| Argument | Beschrijving |
|---|---|
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition report-health
Hiermee wordt een statusrapport verzonden op de Service Fabric-partitie.
Rapporteert de status van de opgegeven Service Fabric-partitie. Het rapport moet de informatie bevatten over de bron van het statusrapport en de eigenschap waarop het wordt gerapporteerd. Het rapport wordt verzonden naar een Service Fabric-gatewaypartitie, die wordt doorgestuurd naar het statusarchief. Het rapport kan worden geaccepteerd door de gateway, maar geweigerd door het statusarchief na extra validatie. Het statusarchief kan bijvoorbeeld het rapport weigeren vanwege een ongeldige parameter, zoals een verlopen volgnummer. Als u wilt zien of het rapport is toegepast in het statusarchief, controleert u of het rapport wordt weergegeven in de sectie Gebeurtenissen.
Argumenten
| Argument | Beschrijving |
|---|---|
| --health-property [Vereist] | De eigenschap van de statusinformatie. Een entiteit kan statusrapporten hebben voor verschillende eigenschappen. De eigenschap is een tekenreeks en geen vaste opsomming om de flexibiliteit van de rapportrapporteur te bieden om de statusvoorwaarde te categoriseren die het rapport activeert. Een reporter met SourceId LocalWatchdog kan bijvoorbeeld de status van de beschikbare schijf op een knooppunt controleren, zodat de eigenschap AvailableDisk op dat knooppunt kan worden weergegeven. Dezelfde journalist kan de connectiviteit van het knooppunt bewaken, zodat deze een eigenschap Connectiviteit op hetzelfde knooppunt kan rapporteren. In het statusarchief worden deze rapporten behandeld als afzonderlijke status gebeurtenissen voor het opgegeven knooppunt. Samen met de SourceId identificeert de eigenschap de statusgegevens op unieke wijze. |
| --status [vereist] | Mogelijke waarden zijn: 'Ongeldig', 'OK', 'Waarschuwing', 'Fout', 'Onbekend'. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --source-id [vereist] | De bronnaam die de client-/watchdog-/systeemcomponent identificeert die de statusgegevens heeft gegenereerd. |
| --beschrijving | De beschrijving van de statusinformatie. Het vertegenwoordigt vrije tekst die wordt gebruikt om leesbare informatie over het rapport toe te voegen. De maximale tekenreekslengte voor de beschrijving is 4096 tekens. Als de opgegeven tekenreeks langer is, wordt deze automatisch afgekapt. Wanneer de beschrijving wordt afgekapt, bevatten de laatste tekens van de beschrijving de markering [Afgekapt], en de totale tekenreeksgrootte is 4096 tekens. De aanwezigheid van de markering geeft aan gebruikers aan dat afkapping is opgetreden. Houd er rekening mee dat wanneer de beschrijving wordt afgekapt, minder dan 4096 tekens uit de oorspronkelijke tekenreeks bevat. |
| --onmiddellijk | Een vlag die aangeeft of het rapport onmiddellijk moet worden verzonden. Er wordt een statusrapport verzonden naar een Service Fabric-gatewaytoepassing, die wordt doorgestuurd naar het statusarchief. Als Direct is ingesteld op true, wordt het rapport onmiddellijk van HTTP Gateway naar het statusarchief verzonden, ongeacht de clientinstellingen voor infrastructuur die de HTTP Gateway-toepassing gebruikt. Dit is handig voor kritieke rapporten die zo snel mogelijk moeten worden verzonden. Afhankelijk van de timing en andere omstandigheden kan het verzenden van het rapport nog steeds mislukken, bijvoorbeeld als de HTTP-gateway is gesloten of het bericht de gateway niet bereikt. Als Direct is ingesteld op False, wordt het rapport verzonden op basis van de statusclientinstellingen van de HTTP-gateway. Daarom wordt deze batched volgens de HealthReportSendInterval-configuratie. Dit is de aanbevolen instelling omdat de statusclient berichten voor statusrapportage kan optimaliseren in het statusarchief en de verwerking van statusrapporten. Rapporten worden standaard niet onmiddellijk verzonden. |
| --remove-when-expired | Waarde die aangeeft of het rapport wordt verwijderd uit het statusarchief wanneer het verloopt. Als dit is ingesteld op true, wordt het rapport verwijderd uit het statusarchief nadat het is verlopen. Als dit is ingesteld op onwaar, wordt het rapport behandeld als een fout wanneer deze is verlopen. De waarde van deze eigenschap is standaard onwaar. Wanneer clients periodiek rapporteren, moeten ze RemoveWhenExpired false (standaard) instellen. Op deze manier heeft de journalist problemen (bijvoorbeeld een impasse) en kan deze niet rapporteren. De entiteit wordt als fout geëvalueerd wanneer het statusrapport verloopt. Hiermee wordt de entiteit als foutstatus opgegeven. |
| --reeksnummer | Het volgnummer voor dit statusrapport als een numerieke tekenreeks. Het volgnummer van het rapport wordt door het statusarchief gebruikt om verlopen rapporten te detecteren. Als dit niet is opgegeven, wordt een volgnummer automatisch gegenereerd door de statusclient wanneer een rapport wordt toegevoegd. |
| --time-out -t | Standaard: 60. |
| --Ttl | De duur waarvoor dit statusrapport geldig is. In dit veld wordt ISO8601 indeling gebruikt voor het opgeven van de duur. Wanneer clients periodiek rapporteren, moeten ze rapporten met een hogere frequentie verzenden dan time to live. Als clients rapporteren over de overgang, kunnen ze de time to live instellen op oneindig. Wanneer time-to-live verloopt, wordt de statusgebeurtenis die de statusgegevens bevat verwijderd uit het statusarchief, als RemoveWhenExpired waar is of wordt geëvalueerd als RemoveWhenExpired false is. Als dit niet is opgegeven, wordt time-to-live standaard ingesteld op oneindige waarde. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl-partitie opnieuw opstarten
Met deze API worden sommige of alle replica's of exemplaren van de opgegeven partitie opnieuw gestart.
Deze API is handig voor het testen van failovers. Als deze wordt gebruikt voor een staatloze servicepartitie, moet RestartPartitionMode AllReplicasOrInstances zijn. Roep de GetPartitionRestartProgress-API aan met dezelfde OperationId om de voortgang op te halen.
Argumenten
| Argument | Beschrijving |
|---|---|
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --restart-partition-mode [vereist] | Beschrijven welke partities opnieuw moeten worden opgestart. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
herstartstatus van sfctl-partitie
Hiermee wordt de voortgang van een PartitionRestart-bewerking gestart met StartPartitionRestart.
Hiermee wordt de voortgang van een PartitionRestart gestart met StartPartitionRestart met behulp van de opgegeven OperationId.
Argumenten
| Argument | Beschrijving |
|---|---|
| --operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --service-id [vereist] | De identiteit van de service. Deze id is doorgaans de volledige naam van de service zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de servicenaam bijvoorbeeld 'fabric:/myapp/app1/svc1' is, is de service-id 'myapp~app1~svc1' in 6.0+ en 'myapp/app1/svc1' in eerdere versies. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl partition svc-name
Hiermee haalt u de naam op van de Service Fabric-service voor een partitie.
Hiermee wordt de naam van de service voor de opgegeven partitie ophaalt. Er wordt een 404-fout geretourneerd als de partitie-id niet bestaat in het cluster.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Volgende stappen
- De Service Fabric CLI instellen .
- Meer informatie over het gebruik van de Service Fabric CLI met behulp van de voorbeeldscripts.