mirror of
https://github.com/facebook/sapling.git
synced 2024-10-04 22:07:44 +03:00
1669ef5b5a
The internal and external repositories are out of sync. This Pull Request attempts to brings them back in sync by patching the GitHub repository. Please carefully review this patch. You must disable ShipIt for your project in order to merge this pull request. DO NOT IMPORT this pull request. Instead, merge it directly on GitHub using the MERGE BUTTON. Re-enable ShipIt after merging.
135 lines
3.4 KiB
Thrift
135 lines
3.4 KiB
Thrift
/*
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
namespace java com.facebook.fb303.core
|
|
namespace java.swift com.facebook.swift.fb303.core
|
|
namespace cpp facebook.fb303
|
|
namespace py.asyncio fb303_asyncio.fb303_core
|
|
namespace perl fb303
|
|
namespace hack fb303
|
|
namespace node_module fb303
|
|
namespace go fb303.thrift.fb303_core
|
|
namespace js fb303
|
|
|
|
/**
|
|
* Common status reporting mechanism across all services
|
|
*/
|
|
enum fb303_status {
|
|
DEAD = 0,
|
|
STARTING = 1,
|
|
ALIVE = 2,
|
|
STOPPING = 3,
|
|
STOPPED = 4,
|
|
WARNING = 5,
|
|
}
|
|
|
|
/**
|
|
* Standard base service interface.
|
|
*
|
|
* This interface provides methods to get some service metadata that is common
|
|
* across many services.
|
|
*/
|
|
service BaseService {
|
|
/**
|
|
* Gets the status of this service
|
|
*/
|
|
fb303_status getStatus() (priority = 'IMPORTANT');
|
|
|
|
/**
|
|
* Returns a descriptive name of the service
|
|
*/
|
|
string getName();
|
|
|
|
/**
|
|
* Returns the version of the service
|
|
*/
|
|
string getVersion();
|
|
|
|
/**
|
|
* User friendly description of status, such as why the service is in
|
|
* the dead or warning state, or what is being started or stopped.
|
|
*/
|
|
string getStatusDetails() (priority = 'IMPORTANT');
|
|
|
|
/**
|
|
* Gets the counters for this service
|
|
*/
|
|
map<string, i64> getCounters() (thread = 'eb');
|
|
|
|
/**
|
|
* Gets a subset of counters which match a
|
|
* Perl Compatible Regular Expression for this service
|
|
*/
|
|
map<string, i64> getRegexCounters(1: string regex) (thread = 'eb');
|
|
|
|
/**
|
|
* Get counter values for a specific list of keys. Returns a map from
|
|
* key to counter value; if a requested counter doesn't exist, it won't
|
|
* be in the returned map.
|
|
*/
|
|
map<string, i64> getSelectedCounters(1: list<string> keys) (thread = 'eb');
|
|
|
|
/**
|
|
* Gets the value of a single counter
|
|
*/
|
|
i64 getCounter(1: string key) (priority = 'IMPORTANT');
|
|
|
|
/**
|
|
* Gets the exported string values for this service
|
|
*/
|
|
map<string, string> getExportedValues() (priority = 'IMPORTANT');
|
|
|
|
/**
|
|
* Get exported strings for a specific list of keys. Returns a map from
|
|
* key to string value; if a requested key doesn't exist, it won't
|
|
* be in the returned map.
|
|
*/
|
|
map<string, string> getSelectedExportedValues(1: list<string> keys) (
|
|
priority = 'IMPORTANT',
|
|
);
|
|
|
|
/**
|
|
* Gets a subset of exported values which match a
|
|
* Perl Compatible Regular Expression for this service
|
|
*/
|
|
map<string, string> getRegexExportedValues(1: string regex);
|
|
|
|
/**
|
|
* Gets the value of a single exported string
|
|
*/
|
|
string getExportedValue(1: string key) (priority = 'IMPORTANT');
|
|
|
|
/**
|
|
* Sets an option
|
|
*/
|
|
void setOption(1: string key, 2: string value);
|
|
|
|
/**
|
|
* Gets an option
|
|
*/
|
|
string getOption(1: string key);
|
|
|
|
/**
|
|
* Gets all options
|
|
*/
|
|
map<string, string> getOptions();
|
|
|
|
/**
|
|
* Returns the unix time that the server has been running since
|
|
*/
|
|
i64 aliveSince() (priority = 'IMPORTANT');
|
|
}
|